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PREFACE 



The software developed by the Information Technology Division staff for the operation of the 
high-speed IBM 370-compatible computers can be described as a multiprogramming supervisor that 
handles a number of resident, reentrant programs. Among them is a large subsystem, called MTS 
(Michigan Terminal System), for command interpretation, execution control, file management, and 
accounting maintenance. Most users interact with the computer's resources through MTS. 

The MTS Manual is a series of volumes that describe in detail the facilities provided by the 
Michigan Terminal System. Administrative policies of the Information Technology Division and the 
physical facilities provided are described in other publications. 

The MTS volumes now in print are listed below. The date indicates the most recent edition of each 
volume; however, since volumes are periodically updated, users should check the file 
*CCPUBLICATIONS, or watch for announcements in the U-M Computing News, to ensure that their 
MTS volumes are fully up to date. 

Volume 1 The Michigan Terminal System, January 1984 

Volume 2 Public File Descriptions, January 1987 

Volume 3 System Subroutine Descriptions, April 1981 

Volume 4 Terminals and Networks in MTS, March 1984 

Volume 5 System Services, May 1983 

Volume 6 FORTRAN in MTS, October 1983 

Volume 7 PL 1 1 in MTS, September 1982 

Volume 8 LISP and SLIP in MTS, June 1976 

Volume 9 SNOBOL4 in MTS, September 1975 

Volume 10 BASIC in MTS, December 1980 

Volume 11 Plot Description System, August 1978 

Volume 12 PIL/2inMTS, December 1974 

Volume 13 The Symbolic Debugging System, September 1985 

Volume 14 360/ 370 Assemblers in MTS, May 1983 

Volume 15 FORMAT and TEXT360, April 1977 

Volume 16 ALGOL W in MTS, September 1980 

Volume 17 Integrated Graphics System, December 1980 

Volume 18 The MTS File Editor, February 1988 

Volume 19 Tapes and Floppy Disks, November 1986 

Volume 20 Pascal in MTS, December 1985 

Volume 21 MTS Command Extensions and Macros, April 1986 

Volume 22 Utilisp in MTS, February 1988 

Volume 23 Messaging and Conferencing in MTS, March 1987 

Other volumes are in preparation. The numerical order of the volumes does not necessarily reflect 
the chronological order of their appearance; however, in general, the higher the number, the more 
specialized the volume. Volume 1, for example, introduces the user to MTS and describes in general 
the MTS operating system, while Volume 10 deals exclusively with BASIC. 
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The attempt to make each volume complete in itself and reasonably independent of others in the 
series naturally results in a certain amount of repetition. Public file descriptions, for example, may 
appear in more than one volume. However, this arrangement permits the user to buy only those 
volumes that serve his or her immediate needs. 

Richard A. Salisbury 
General Editor 
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PREFACE TO VOLUME 18 



The following changes have been made to the MTS File Editor since the previous edition of MTS 
Volume 18 was issued: 

(1) The $EDIT command now accepts file-name patterns. Each file in the pattern sequence 
will be edited. 

(2) The SAVE and REMEMBER commands have been added to save and remember states of 
the edit session. 

(3) The VMARK command has been added to define an editor region in visual mode. 

(4) The PRINT VMSG command has been added to print a message below the vruler/status 
line in visual mode. 

(5) The VPF ATTN and VPF RETURN commands have been added for assigning the ATTN 
and RETURN keys in visual mode. 

(6) The following new predefined editor variables have been added: 

ED_COUNT 

ED_SAVENAME 

ED_TIME 

ED_VMARK_FIRST_COL 

ED_VMARK_FIRST_LINE 

ED_VMARK_LAST_COL 

ED VMARK LAST LINE 
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EDIT MODE 



BASIC CONCEPTS 

The MTS file editor is used for editing MTS files. The editor is invoked by entering the MTS 
command 

$EDIT filename 

where "filename" is the name of the MTS file to be edited (the edit file). If "filename" is omitted from 
the $EDIT command, the previous edit file remains the edit file, "filename" may be an MTS file-name 
pattern, in which case each file satisfying the pattern will be sequentially edited. 

A "one-shot" command may be executed by appending an edit command to the $EDIT command in 
the form 

$EDIT filename :edit-command 

Editor commands are read from the pseudodevice *SOURCE* and editor output messages, 
diagnostics, and verification comments are written on *SINK*. When the edit file is ready for editing, 
the editor prints a colon ":". This prefix character indicates that the editor is ready to process edit 
commands. 

A simple edit session (using an unpatterned file name) is terminated by entering the STOP edit 
command or an end-of-file condition. The session may be suspended temporarily by entering the MTS 
or the RETURN edit command. A one-shot command will also leave the edit session loaded 
(suspended). All of the above responses cause the system to return to the caller (normally MTS 
command mode). While in MTS command mode, any MTS command may be executed. If a 
subsequent $EDIT command is entered after a previous edit session was suspended, the same edit 
session is reactivated; if the previous edit session was terminated, a new edit session is initiated. A 
simple edit session may be suspended any number of times. When an edit session is suspended, all 
checkpoint information and all settings of global editor SET options (described later in this section) are 
preserved. When an edit session is terminated, all of this information is released. The edit file may 
be changed in the same edit session by entering the edit command 

EDIT filename 

Selecting a new file for editing does not affect the setting of the global editor SET options; however, all 
checkpoint information for the previous file is released. 

If a patterned file name is given with the $EDIT command, an MTS, RETURN, STOP command, or 
an end-of-file condition will cause the next file in the pattern sequence to be edited. An attention 
interrupt will abort the editing sequence. 

There may be only one edit file at any time. Line-number range specifications given with 
"filename" are ignored; the entire file is the edit file. Any explicit or implicit concatenation to other 
files or devices is also ignored. The file is read with the MTS I/O modifiers for implicit concatenation 
and trimming disabled (-JC and -.TRIM). The file is written with trimming disabled. 
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The editor may be used for both line files and sequential files. However, for sequential files, lines 
may not be deleted or changed in length; they only may be inserted at the end of the file. 

COMMAND STRUCTURE 

Edit commands perform the editing functions on the edit file. These functions fall into three 
general categories: 

(1) changing the contents of the file, 

(2) searching the file for a character string or set of character strings, and 

(3) setting global editor options and modifiers. 

Each command may be abbreviated, usually by one or two characters. A few commands begin with 
nonalphabetic characters. The editor scans the entire command name to ensure that it is correctly 
spelled. 

An attention interrupt immediately terminates the current edit command; the editor returns to edit 
command mode. A second attention interrupt without an intervening edit command causes the editor 
to return to MTS. The editor may be reentered by issuing the $EDIT command. 

Line-number parameters, string parameters, and modifiers are used in edit commands. These are 
described below. 

Line Numbers 

Each line in a file is referenced by a line number. A line number is specified as a number ranging 
from -2147483.648 to +2147483.647 with at most three decimal places. There are seven special 
symbols that may also be used for line numbers: 

*F is the first line in the file 

*L is the last line in the file 

* is the current line in the file 

*N is the next line in the file 

*P is the previous line in the file 

*VT is the top line of the visual-mode screen 

*VB is the bottom line of the visual-mode screen 

If the file is empty, the above seven special symbols initially have the value of 1. 

Any of the specifications below may be used in place of a line-number parameter "lpar" in the 
command prototypes given in this volume. 

(1) linenumber 

This specifies a single line. This may be given in the form of an explicit line number or 
one of the above special symbols, e.g., 1, 50, -100, *F, or *L. 

(2) linenumber linenumber 
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This specifies a range of lines beginning with the first line number and continuing to the 
second. The line numbers may be given in ascending or descending order, e.g., 10 20, 200 
100. 

(3) linenumber COUNT=n 

This specifies "n" line numbers beginning with "linenumber". "n" is a directional count; 
if "n" is negative, the lines are taken in descending line-number order starting with the 
line specified. 

(4) static predefined regions 

See the section "Regions" below. 

(5) dynamic predefined regions 
See the section "Regions" below. 

(6) /name 

This is the line-number region specified by "/name". See the section "Regions" below for 
details of defining region names. 

(7) COUNT=n 

This is the same as (3), but starts with the current line (*). 

(8) (linenumber,linenumber) 

This is an alternate form for (2). The parentheses provide clarity when specifying 
line-number lists (10). 

(9) (linenumber,COUNT=n) 

This is an alternate form for (3). The parentheses provide clarity when specifying 
line-number lists (10). 

(10) line-number lists 

This is a list of one or more elements of the form (1) through (9), each element separated 
by a comma, e.g., (*F, 1 10, *L). 

(11) COLUMNS={(l,r) I 1} 

A column range may be specified after any of the above line-number parameters. The 
column range restricts the action of the edit command to the width of the file between the 
left and right columns specified. See the section "Column Ranges" for a further 
description of the use of column ranges with edit commands. 

(12) Hexadecimal line numbers are given as X'xxxxxxxx', where "xxxxxxxx" is from one to 
eight hexadecimal digits. When hexadecimal format is used, the internal format of the 
line number is required, which is the external format times 1000. For example, line 
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number 1.000 is represented internally as 1000 and line number 10.000 as 10000. Using 
hexadecimal format, these would be specified as X'3E8' and X'2710', respectively. There 
are two hexadecimal line numbers that have special meaning: X'80000000' represents *F, 
andX'7FFFFFFF' represents *L. 

(13) Character Representation 

Character line numbers are given as C'cccc', where "cccc" is four characters. When 
character format is used, the hexadecimal representation of the character string is used 
as the line number. As with hexadecimal format, the resulting hexadecimal number is 
the internal format of the line number. For example, the line number C'aaaa' is 
equivalent to X'81818181' or -2122219. 135. 

The editor maintains a current-line pointer which points to the current line (*) in the file. The 
current line is initially set to the first line in the file. All edit commands that read or write lines in the 
file move the current-line pointer unless the @NMCL modifier is given on the command or the MCL 
(MOVECURRENTLINE) option is OFF. The LINE command may be used to explicitly set the current 
line. In visual mode, an asterisk will mark the current line if the VMARKER option is ON. 

If no line-number specification is given for an edit command requiring a line-number parameter, the 
current line (*) is assumed. Exception: The SCAN and MATCH commands act on the current line to 
the last line of the file (* *L), if no line-number parameter is specified. 

Strings 

A string is a sequence of characters delimited at each end by a current delimiter character. The set 
of acceptable delimiter characters is as follows: 

■ "*<>? : ;%&-■# 

The first occurrence of a character from this set is taken as the current delimiter character for that 
string. If the command requires a pair of strings, they must be presented in the following form: the 
delimiter, the first character string, the same delimiter, the second character string, and the same 
delimiter. If hexadecimal conversion is ON, the character string is converted to internal character 
form only if it contains legal hexadecimal characters. The following examples illustrate the format of 
strings: 

The character string: 'STRING' 

The null string: 

The hexadecimal string: #E2E3D9C9D5C7# 

A pair of strings: ABC'DEF' 

If the final delimiter (e.g., ") is omitted when entering a string or pair of strings, the editor prints the 
comment 

: Terminating " missing (Y,N) ? 

and waits for a response. If "Y", "YE", or "YES" (either upper- or lowercase) is entered, the missing 
delimiter is appended to the end of the command; otherwise, the command is canceled. If a negative 
response is given, this prompt may be repeated if the PATTERN option is ON. This is because the 
pattern processing algorithm attempts to parse the command after normal command processing has 
failed. 
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Modifiers 



Command modifiers may be applied to edit commands to override the default action of an edit 
command. For example, the @NVERIFY modifier may be specified to suppress verification of edited 
lines. The modifiers are effective only for a single edit command. 

Command modifiers are specified by appending the modifier directly to the command name or as the 
last parameter of the edit command line. The "@" modifier character must precede the modifier. A 
modifier is negated by prefixing the modifier name with the letter "N", the not sign "-.", or the minus 
sign "-". As many modifiers as required may be specified by concatenation. No blanks are allowed 
between the command name and its modifiers, or within a sequence of modifiers. For example, 

ALTER@ALL@NVERIFY 15 COUNT=5 ' gamma - rays ' X - rays ' 
ALTEROALLO-'VERIFY 15 C=5 ' gamma - rays ' X - rays ' 
ALTER 15 C=5 ' gamma - rays ' X - rays ' OALLONVERIFY 

The above three edit command sequences all perform the same function; they alter all occurrences of 
the string "gamma-rays" to "X-rays" in 5 consecutive lines of the file, starting at line number 15, 
without verifying (printing) the results. 

The default action of the edit commands may be permanently changed by editor SET options. Each 
modifier has a corresponding SET option, which may be set to reverse the default action of the modifier. 
In the above example, another equivalent command sequence would be 

SET VERIFY=OFF ALL=ON 

ALTER 15 C=5 ' gamma - rays ■ X - rays ' 

The modifiers are described below. Each description gives the shortest form of the modifier followed 
by a list of acceptable longer names in parentheses. 

@A (@ALL) Default: @NA 

If @A is specified, the ALTER, CHANGE, MATCH, and SCAN commands will process all 
occurrences of the pattern throughout the specified range of the file. If @NA is specified, 
these commands will process only the first occurrence of the pattern. 

@AC (@ANYCASE) Default: @NAC 

If @AC is specified, the ALTER, CHANGE, MATCH, and SCAN commands will match 
any occurrence of alphabetic characters in the pattern regardless of case. If @NAC is 
specified, these commands will match only the exact alphabetic characters as specified in 
the pattern. 

@CH (©CHECKPOINT) Default: @CH 

If @CH is specified and if the checkpoint buffer has been opened by the CHECKPOINT 
command, the results of edit commands are recorded in the buffer so that they may be 
undone if the need arises. See the section "Checkpoint/Restore Facility" below. 

@COL (©COLUMN) Default: @COL 
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If @COL is specified, the action of the edit command applies only to the column range set 
by the COLUMN command (see the description of the COLUMN command). This 
modifier does not apply to the PRINT command; the ©WINDOW modifier should be used 
for printing. 

@HEX (@X, ©HEXADECIMAL) Default: @NHEX 

If @HEX is specified, all character strings given in the command are treated as 
hexadecimal strings. For example, the string 

"C8C5D3D3D640E3C8C5D9C5" 

is equivalent to 

"HELLO THERE" 

when this modifier is specified. Verification of the line text is printed in hexadecimal. 
Using the @HEX modifier with the VISUAL command will cause the visual screen data to 
be represented in hexadecimal format. To change the visual screen back to character 
format, another VISUAL command (without the @HEX modifier) must be executed. 

@LEN (©LENGTH, ©LINELENGTH, @LL) Default: ©NLEN 

If ©LEN is specified, verification of a line includes its length. 
©LNR (©LINENUMBER) Default: ©LNR 

If ©LNR is specified, verification of a line includes its line number. 

©MACRO Default: ©NMACRO 

The INSERT and PROCEDURE commands accept the ©MACRO modifier which causes 
lines read by these commands to be processed with the MTS FDname modifiers 
@MACRO@MFR applied (any line beginning with the MTS command macro flag ">" will 
be processed by the MTS macro processor). By default, lines are read without these MTS 
modifiers. 

©MCL (©MOVECURRENTLINE) Default: ©MCL 

If ©MCL is specified, the current-line pointer (*) is moved by the action of edit commands. 
If ©NMCL is specified, the current-line pointer remains unchanged, even after a 
successful SCAN or MATCH command. 

©NOT Default: ©NNOT 

If ©NOT is specified, the pattern search in the SCAN and MATCH commands is 
successful when the pattern is not found. That is, the search succeeds at any position in 
the line where the pattern string fails to match. For example, this function in 
conjunction with the COLUMN command may be useful in finding a line which does not 
contain a blank in a given column range. 
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@OPL (@ONCEPERLINE) Default: @NOPL 

If @OPL is specified, only one operation such as an alteration or successful scan is allowed 
per line. The specification of @OPL often implies the specification of @A. @OPL is 
necessary when modifying a null string to a nonnull string if @A is also applied. 

@PA (@PRINTALL) Default: @NPA 

If @PA is specified, verification of every alteration of a line is given when both @A and @V 
are specified. If @NPA is specified, only one verification is printed per line regardless of 
the number of alterations made. The @PA modifier only applies to the ALTER and 
CHANGE commands. 

@PC (@PRINTCOLUMN) Default: @NPC 

If @PC is specified, the column number of any successful pattern search is printed. 

@PLN (@PREFIXLINENUMBER) Default: @PLN 

If @PLN is specified and an increment has been specified on the INSERT or VINSERT 
command, the user will be prompted for insertion lines with the line numbers at which 
the lines are to be inserted. 

@RS (@RESCAN) Default: @NRS 

If @RS is specified in combination with the @A modifier, the ALTER and CHANGE 
commands resume pattern scanning at the replaced string (rather than after it) after a 
successful alteration. If @RS and @A are specified, accidental infinite loops may be 
created. For example, 

ALTER@A@RS 123 " the " then " 

would cause the following line: 
Fanner in the dell 

to become: 

Fanner in thennnnnnnnnnnnnnn . . . 

To limit accidental loops, the rescan count at the same column position is limited to a 
number equal to the maximum possible length of the line. 

One useful purpose for the @ALL@RESCAN combination is to alter strings of blanks to one 
blank: 

ALTER@A@RS /FILE " " " 

where all pairs of blanks are changed to a single blank. 

@RTL (@RIGHTTOLEFT) Default: @NRTL 
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If @RTL is specified, pattern scanning is performed from right to left within a line, i.e., the 
last occurrence of the pattern in the line is matched first. Note that the pattern does not 
need to be specified differently. For example, 

SCAM@RTL "the" 
but not 

SCAM@RTL 'eht' 

may be used to match the underlined part of the following sentence: 
I am the only one in the theatre. 

@TR (©TRIM) Default: @NTR 

If @TR is specified, all lines written or changed in the file are trimmed to remove all but 
one trailing blank. 

@TX (@TEXT,@LINETEXT) Default: @TX 

If @TXis specified, verification of a line includes its contents. 

@V (©VERIFY) Default: @V 

If @V is specified, the resulting lines are printed after they are processed by an edit 
command. The following modifiers govern the output produced by verification: @HEX, 
@LEN, @LNR, @PA, @TX, and @W. 

@VMV (@VISUALMODEVERIFY) Default: @NVMV 

If @VMV is specified, verification of commands executed from the work area in visual 
mode will appear in the conversation buffer, i.e., when visual mode is exited, the 
verification will appear on the screen. 

@W (©WINDOW) Default: @W 

If @W is specified, the text of lines printed during verification includes only those column 
ranges specified by the WINDOW command. 

Column Ranges 

Several edit commands apply only to a specified column range in the file. Two column pointers are 
associated with the column range, which is defined as extending from the character pointed to by the 
first column pointer through (and including) that pointed to by the second column pointer. Any edit 
command that specifies a line range "lpar" or a static predefined region may use a COLUMNS 
specification. 

The column pointers may be specified within an edit command by using the COLUMNS keyword in 
the form 

COLUMNS=(f,l) 
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where "f ' is the first column pointer and "1" is the last column pointer. COLUMNS may be abbreviated 
as COL. For example, the command 

SCAN 1 10 COL=(2,4) 'ABC' 

will scan lines 1 through 10 in columns 2 through 4 for the string 'ABC. If only "f is specified, the 
parentheses may be omitted, e.g., 

COL=f 

In this case, the last column pointer defaults to the value set by the previous COLUMN command. In 
order to set a column range to be one character wide, a specification such as COL=(3,3) must be used. 

The column pointers must be in the range of 1 to 32767, the default pointer values. The first 
column pointer must be less than or equal to the value of the second pointer. The values assigned to 
the column range pointers do not place any additional restrictions on the length of the individual lines 
within the files. 

The COLUMN command may be used to set globally the column pointers for all edit commands that 
recognize column ranges. This command is given in the form 

COLUMN fl 

where "f" and "1" are as defined above. If the edit command specifies the COLUMNS keyword, it will 
override the setting of the COLUMN command. 



REGIONS 

A range of lines may be specified by a user-defined name. This name is called a region and takes 
the form 

/name 

where "name" is from 1 to 7 alphanumeric characters. Several regions may be defined within a file. 

The REGION command defines and establishes the scope of a region. The command is given in the 
form 

REGION /name lpar 

where "/name" is the name of the region being defined and "lpar" is the scope of the region. The scope 
value may be any valid line-number specification "lpar" (see the section "Line Numbers" above). A 
region name may be used in place of a line-number parameter in an edit command. 

When region names appear as line-number parameters in the definition of a new region via the 
REGION command, the value of those regions (i.e., the line-number parameters they consist of) are 
copied into the values of the region being defined. Thus, if the current line is 9, the command 

REGION /REG1 1,2, /HEAD 

will result in a definition for REG1 of lines 1 and 2 and the portion of the file from the first line of the file 
through line 9. If the current line is later moved to line 400, the definition of REG1 remains the same. 
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Sometimes it is desirable to make the definition of REG1 change as the value of /HEAD changes. This 
can be done by inserting two slashes (//) at the front of the region name in the line-number parameters 
of the REGION command. For example, if line 9 is the current line, the command 

REGION /REG1 1,2, //HEAD 

would result in the same definition for REG1 as long as line 9 remains the current line. But if the 
current line is moved to line 400, the definition of REG1 changes to lines 1 and 2 and the portion of the 
file from the first line through line 400. This type of deferred evaluation may be done for any region; 
thus, the command 

REGION /X //Y 

will cause the current value of region /Y to be used each time a reference is made to /X in a command. 
There are several predefined regions. 

( 1 ) dynamic predefined regions 

/FILE or /F specifies the entire file: first line to last line (*F *L). 

/TAIL or /T specifies the remainder of the file after the current line (*N *L). 

/HEAD or /H specifies the beginning of the file through the current line (*F *). 

/BACK or /B specifies, in reverse order, the portion of the file starting with the line 

just before the current line and ending with the first line of the file (*P 
*F). 

/REVERSE or /R specifies the entire file in reverse order, last line to first line (*L *F). 

/VISUAL or /V specifies the current visual-mode screen (*VT *VB). 

/VMARK specifies the current user-defined visual-mode region (see the 

VMARK visual-mode command). 

(2) dynamic predefined regions 

/SCAN or /S specifies all lines successfully matched by the last SCAN command. 

/MATCH or /M specifies all lines successfully matched by the last MATCH command. 

EDITOR INITIALIZATION FILE 

An editor initialization file may be specified by the MTS command 

$SET INITFILE(EDIT)=filename 

When the editor is being initialized, a check will be made to determine if an initialization file has been 
specified. If so, the editor will read initializing commands from the specified file before reading 
commands from *SOURCE* or before processing the command specified on the $EDIT command. 
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The editor initialization file is the preferred method of presetting editor options and edit procedures. 
Instead of initializing the editor in the user's sigfile, which is effective only once and only for the 
invocation of the editor from the MTS command language, using the initialization file is effective for all 
initializations of the editor including initializations of the editor via the EDIT subroutine. The EDIT 
subroutine is used, for example, to invoke the editor from the MTS message system ($MESSAGE). 

For example, a user might include the command 

$SET INITFILE (EDIT) =EDITSETUP 

in his or her sigfile, where the file EDITSETUP could contain the editor commands 

SET PATTERNS=ON 
CHECKPOINT FULL 

The initialization file may contain any edit command except for the MTS, RETURN, or STOP 
commands. It also may contain visual-mode commands and edit-procedure definitions. These are 
described in the sections "Visual-Mode Commands" and "Edit Procedures." 

The initialization file facility may be disabled by the MTS command 

$SET INITFILE(EDIT)=OFF 

CHECKPOINT/RESTORE FACILITY 

The checkpoint/restore facility may be used to preserve the state of the edit file so that recovery may 
be made from accidental destruction of all or part of its contents. This facility is controlled by the 
CHECKPOINT command and is given in the form 

CHECKPOINT {ON I OFF I NEVER} 

When the checkpoint/restore facility is enabled, a checkpoint buffer is opened. This buffer is used to 
record the action of edit commands and can be used to recover the previous contents of the file, if 
necessary. 

If the CHECKPOINT ON command is given, a checkpoint buffer is opened, and the current contents 
of the file is established as the checkpoint base. All commands that modify the file are recorded in the 
buffer. Either the RESTORE or UNDO commands may be used to recover the contents of the file as of 
the checkpoint base. The RESTORE command is used to restore the entire file or a portion thereof 
and is given in the form 

RESTORE [lpar] 

For example, the command 

RESTORE 1 20 

restores the contents of lines 1 through 20 of the file. The RESTORE command always restores the 
specified portion of the file to the state of the checkpoint base. The UNDO command is used to restore 
the file to its state before the last edit command that modified the file and is given in the form 

UNDO 
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For example, the command sequence 

DELETE 1 20 
UNDO 

deletes lines 1 through 20 and then restores them to the file. 

If the CHECKPOINT OFF command is given, a checkpoint buffer is still opened, but only the action 
of the last command that modified the file is recorded in the buffer. At this level, the UNDO command 
may be used to reverse the action of the last file-modifying command. The RESTORE command may 
only be used to restore a subset of lines changed by the last command. This is particularly useful when 
a line has been unintentionally altered through the use of the @A modifier. 

If the CHECKPOINT NEVER command is given, no checkpoint information is saved. The previous 
checkpoint buffer is discarded. The RESTORE and UNDO commands have no effect. 

If the CHECKPOINT command has not been given, the level of the checkpoint/restore facility 
defaults to OFF. 

The CHECKPOINT global option and the @CH modifier may be used in conjunction with the 
CHECKPOINT command to further control the checkpoint/restore facility. The option may be set to 
either ON or OFF by the SET command; the default is ON. 

When both the CHECKPOINT option is ON and the CHECKPOINT ON command is given, the 
action of all commands is recorded in the checkpoint buffer. However, the checkpointing feature may 
be suppressed for a specific command by appending the @NCH modifier to the command. In this case, 
the action of that command is not recorded in the checkpoint buffer. Alternatively, if the 
CHECKPOINT option is set to OFF and checkpointing has been initiated with the CHECKPOINT ON 
command, then only those commands appended with a @CH modifier are recorded in the checkpoint 
buffer. These two methods allow the user to select the commands that are to be checkpointed. 

In cases where many modifications are being made to a file, the virtual memory available to 
checkpoint changes may be exhausted if CHECKPOINT ON is specified. The error messsage 

GETSPACE unable to allocate space. Checkpoint information lost, 
will appear if this occurs. This error is less likely to occur if CHECKPOINT is OFF. 

EDIT PROCEDURES 

An edit procedure is a sequence of edit commands stored as a program within the editor. These 
commands are executed by the editor when the edit procedure is executed. This allows the user to 
repeatedly execute commands without having to explicitly reenter them. 

The PROCEDURE command is used to create an edit procedure and to enter the commands that 
comprise the edit procedure. The PROCEDURE command takes the form: 

PROCEDURE !name 

where "name" is a 1- to 254-character, alphanumeric, edit-procedure name (the ! prefix must always be 
present). After the PROCEDURE command is given, the user will be prompted to enter the procedure 
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commands comprising the body of the list. For example, the following simple procedure IJUST65 
left-justifies a file to fit within the column range of 1 to 65: 

: PROCEDURE 1JUST65 
?JUSTIFY /FILE LEFT 1 65 
?END 



The definition of the edit procedure is terminated by entering the END command, a null line, or an 
end-of-file. If the user already had an edit procedure named ! JUST65, its contents would be erased 
before the new command list is entered. 

The GOTO command may be used within a procedure to control looping. For example, the 
following procedure !LIST may be defined to print all lines that begin with the character string "***"; 

: PROCEDURE !LIST 

?LINE@NV *F 

?LOOP: SCAN@NV * *L POS(O) '***' 



? 


GOTO END ON FAILURE 


? 


PRINT * 


? 


LINE@NV *N 


? 


GOTO END ON ENDOFFILE 


? 


GOTO LOOP 



?END 



Three edit procedure switches are defined. Two of these switches, SUCCESS and FAILURE, are 
set as the result of the success or failure of an edit command that performs a pattern-searching 
operation (ALTER, MATCH, SCAN, etc.). Such a command succeeds if it fulfills its function at least 
once within its specified line range; in this case, the SUCCESS switch is enabled and the FAILURE 
switch is disabled. Such a command fails if it exceeds its line range or encounters an end-of-file before 
fulfilling its function; in this case, the FAILURE switch is enabled and the SUCCESS switch is 
disabled. The third edit procedure switch is the ENDOFFILE switch. This switch is enabled if an 
end-of-file is encountered during the processing of an edit command or if a line-number parameter 
refers to an empty set of lines; it is disabled if the command is completed without an end-of-file 
occurring (at least one line must be specified by the line-number range parameter). 

These switches may be tested by the GOTO command to allow conditional branching in the 
procedure. In the above example, the command sequence 

SCAN@NV * *L POS(O) '***' 
GOTO END ON FAILURE 

branches to the end of the procedure (exits) if the FAILURE switch is enabled by the failure of the 
completion of the SCAN command, i.e., if the pattern POS(O) '***' is not found within the * *L line 
range. 

An optional label may be prefixed to each command in the procedure command list. The label may 
be from 1 to 8 characters long and must be immediately followed by a colon. This label is used for 
branching by the GOTO command. In the above example, the command sequence 

LOOP: SCAN@NV * *L POS(O) '***' 
GOTO LOOP 
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illustrates the use of labels and GOTO looping. 

An edit procedure is executed via the EXECUTE command or by issuing the edit procedure name 
"!name" as a command: 

EXECUTE !name 

or 

!name 

The following example creates an edit procedure 1ALPHA, which alters all occurrences in the file of 
the string 'alpha' to the string 'beta', while saving a copy of each altered line in the temporary file 
-ALPHA. 

PROCEDURE ! ALPHA 

LINE@NV *F 

LOOP: SCANONV * *L 'alpha' 

GOTO END ON FAILURE 

COPY@NV * TO F=-ALPHA(*L+1) 

ALTER * 'alpha 'beta' 

GOTO LOOP 
END 

This edit procedure may be executed by the command 

EXECUTE ! ALPHA 

The execution processing for this procedure is as follows. The first command sets the current-line 
pointer to the first line of the edit file. A SCAN command is then executed to scan for the first 
occurrence of the string 'alpha'. If such a string is found, the current-line pointer is moved to the line 
containing the string. A COPY command is executed to save the line in the temporary file and then an 
ALTER command is executed to alter the 'alpha' to 'beta'. This continues until the SCAN command 
fails. 

The @NV modifier is appended to the SCAN and COPY commands in the above example to suppress 
the printing of command verification. Command verification could be suppressed for all commands in 
the procedure by issuing the edit command SET VERIFY=OFF at the beginning of the procedure and 
then issuing the command SET VERIFY=ON at the end of the procedure: 

PROCEDURE ! ALPHA 

SET VERIFY=OFF 

LINE *F 

LOOP: SCAN * *L 'alpha' 

GOTO EXIT ON FAILURE 

COPY * TO F=- ALPHA (*L+1) 

ALTER * 'alpha 'beta' 

GOTO LOOP 
EXIT: SET VERIFY=ON 
END 

A procedure may be executed more than once by specifying a count on the EXECUTE command in 
the form 

EXECUTE !name count 
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or 



!name count 

where "count" specifies the number of times the procedure is to be executed. For example, the 
following procedure 1LISTN could be defined to list the next "n" lines of the file: 

: PROCEDURE 1LISTN 
?LINE@NV * 
? PRINT * 
?LINE@NV *N 
?END 



In order to list the next 10 lines of the line starting from the current line, the procedure would be 
executed as 

EXECUTE 1LISTN 10 

The special edit counter COUNT also may be used with the GOTO command to control the number 
of times a procedure or part of a procedure is executed. Initially, COUNT is set to the value of "count" 
given on the EXECUTE command. If "count" is omitted, COUNT is set to one. Each time the 
command GOTO COUNT is executed within the procedure, the value of count is decremented by one. 
When COUNT reaches zero, execution of the procedure is terminated. For example, the procedure 
1LIST given above could be rewritten to print out the next "n" lines in the file that begin with "***"; 

: PROCEDURE !LIST 

?LINE@NV *F 

?LOOP: SCAN@NV * *L POS(0) '***' 

? GOTO END ON FAILURE 

? PRINT * 

? GOTO COUNT 

? LINE@NV *N 

? GOTO END ON ENDOFFILE 

? GOTO LOOP 

?END 

The edit procedure is checked for correct syntax when it is executed. If errors are detected, 
execution is suppressed. The procedure may be edited to correct the errors in the same manner as a 
file is edited, i.e., 

EDIT PROCEDURE !name 
edit-command 



The contents of the procedure may be printed by giving the command 

PRINT !name 
The names of all currently defined procedures may be printed by giving the command 

PRINT PROCEDURES 
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Execution of an edit procedure is not the same as the execution of an edit command. There are 
some subtle, but important, differences: 

(1) The action of an entire edit procedure may not be reversed by an UNDO command since 
an UNDO only reverses the action of the last edit command. However, if CHECKPOINT 
ON is given at the beginning of the procedure, a RESTORE command will reverse the 
action of the entire procedure. 

(2) The time limit that governs individual edit commands does not govern an entire edit 
procedure (see the SET TIMEINTERVAL command). Therefore, it is possible to code 
infinite loops into a procedure. Care should be taken to ensure that the terminating 
conditions of a loop (ON SUCCESS, ON FAILURE, ON ENDOFFILE) will actually be 
met at some point. 

(3) The value of the current-line pointer may change many times as an edit procedures 
executes. Users should take care to initialize and increment lines correctly. Notice 
that this was done with the commands LINE@NV *F and LINE@NV *N in the procedure 
example above. 

The definition of an edit procedure is normally discarded when the edit session is terminated. 
However, the definition may be saved and restored in one of three ways: 

(1) The definition may be inserted into a sigfile file so that it is redefined each time the user 
signs on. For example, the procedure IJUST65 could be stored in part of the users sigfile 
in the following manner: 

$EDIT 
* 

* Procedure to justify a file 
* 

PROCEDURE 1JUST65 
JUSTIFY /FILE LEFT 1 65 
END 
MTS 

(2) The definition may be inserted into an editor initialization file so that it is redefined each 
time the editor is entered. This method is similar to the above method except that the 
$EDIT and MTS commands are omitted: 

* 

* Procedure to justify a file 
* 

PROCEDURE 1JUST65 
JUSTIFY /FILE LEFT 1 65 
END 

(3) The definition may be saved in a permanent file and then retrieved when the user 
requires the procedure. The procedure (assuming that it is currently defined by the 
editor) is saved by issuing the following commands: 

$CREATE PROC.JUST65 

$EDIT 

EDIT PROC IJUST65 

COPY /FILE TO F=PROC. JUST65 
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The procedure may be retrieved by issuing the following commands: 



$EDIT 

EDIT PROC IJUST65 

COPY F=PROC. JUST65 TO * 



VISUAL MODE 

For the display-screen terminal user, the visual-mode feature provides a very powerful method for 
entering data into a newly created file or for editing an existing file. The visual-mode feature is 
supported on a wide variety of display-screen terminals and is described in the section "Visual Mode" at 
the end of this volume. 



PATTERN MATCHING 

The editor provides a pattern-matching feature that allows the user to perform more sophisticated 
operations on a file than mere string searching or replacement. This feature is described in the section 
"Pattern Matching" at the end of this volume. 



RECORDING THE STATUS OF THE EDITOR 

The CSSET subroutine is called after each editor command is executed. This enables the MTS 
command-language extensions facility (the MTS macro processor) to determine the result of an editor 
command. The following codes are used: 



Origin value: 648 






Status 


Summary 


Code 


Execution success 








Warning issued 
End-of-file 
"Search failed" 


1 
1 
1 



1 
2 


Attention occurred 
Illegal modifier 
Illegal command 
Prescan failed 
Severe error 
Error message issued 
Execution failed 
Parse failed 


2 
2 
2 
2 
2 
2 
2 
2 


1 
2 
3 
4 
5 
6 
7 
8 



Unknown failure 2 -1 

See the description of the CSSET subroutine in MTS Volume 3, System Subroutine Descriptions, and in 
MTS Volume 21, MTS Command Extensions and Macros, for further information about using the 
editor status information. 
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MTS EDITOR COMMANDS 

The following notation conventions are used in the prototypes of the commands: 

lowercase represents a generic type which is to be replaced by an item supplied by the 

user, 
uppercase indicates material to be repeated verbatim in the command, 

brackets [ ] indicate that material within the brackets is optional, 

braces { I } indicate that the material within the braces represents choices, from which 

exactly one must be selected. The choices are separated by vertical bars, 
ellipsis ... indicates that the preceding syntactic unit may be repeated, 

underlining indicates the minimum unambiguous form of the command or parameter. 

Longer abbreviations are accepted. 

In the command descriptions that follow, a string expression "strexp" is a combination of one or 
more strings and/or variables whose values are strings. 

The following pages give a complete summary of the commands in the editor command language. 



Summary of Editor Command Prototypes 



Commands 


Parameters 


ALTER 


[lpar] ['stringl'string2'] 


ALTER 


[lpar] pattern 


APPEND 


[lpar] [strexp] 


BLANK 


[lpar] [strexp] 


CHANGE 


[lpar] ['stringl'string2'] 


CHANGE 


[lpar] pattern 


CHECKPOINT 


[{ON 1 OFF 1 NEVER}] 


CLOSE 




COLUMN 


[first [last]] 


COMBINE 


[lpar] [LEN=n] 


{COMMENT 1 *} 


[message] 


CONCATENATE 


[lpar] [LEN=n] 


COPY 


[{lpar 1 F=FDname [COUNT=n]}] [[TO] {linenumber 1 F=FDname}] 




[COPIES=n] 


CORRECT 


[lpar] [strexp] 


COUNT 


[lpar] 


DELETE 


[lpar] [OK] 


EDIT 


{filename 1 PROCEDURE Iname 1 VPF pfname 1 




MACRO macro-name} [[:]edit-command] 


EXECUTE 


{Iname [n] 1 'edit-command' 1 ED_WORK} 


EXPLAIN 


[command] 


GOTO 


label [[ON] condition] 


INSERT 


[linenumber] [strexp] 


INSERT 


[linenumber] [INCREMENT=increment] 


JUSTIFY 


[lrange] [{LEFT 1 RIGHT 1 BOTH} lmar rmar] 


LET 


variable=value 


LINE 


[linenumber] [{increment 1 COUNT=n}] 


MATCH 


[lpar] ['string'] 
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MATCH 


[lpar] pattern 


MATCH 


VARIABLE=var-name pattern 


MCMD 


MTS-command 


MOVE 


[lpar] [[TO] {linenumber 1 F=FDname}] 


MTS 


[MTS-command] 


OVERLAY 


[lpar] [strexp] 


PRINT 


[lpar] [CHECKPOINT] 


PRINT 


{COLUMNS 1 FILENAME 1 PROCEDURES 1 




REGIONS 1 SAVES 1 VARS 1 VPFS 1 WINDO 


PRINT 


{VARname 1 Iname} 


PRINT 


{MESSAGE 1 MSG 1 VMSG} strexp 


PROCEDURE 


!name 


REGION 


/name lpar 


REMEMBER 


[name] 


RENUMBER 


[first last] [beg [inc]] 


REPLACE 


[lpar] [strexp] 


RESTORE 


[lpar] 


RETURN 




SAVE 


[name] 


SCAN 


[lpar] ['string'] 


SCAN 


[lpar] pattern 


SCAN 


VARIABLE=var-name pattern 


SET 


keyword=value ... 


SHIFT 


[lpar] {LEFT 1 RIGHT} count 


SPREAD 


[lpar] 


STOP 




TRANSLATE 


[lpar] ['stringl'string2'] 


TRANSLATE 


[lpar] [[FROM] fromset] [TO] toset 


TRANSLATE 


[lpar] strexpl=strexp2 


UNDO 




UNLK 




UNLOCK 




VISUAL 


[linenumber] 


WINDOW 


[left [right]] 


WINDOW 


{LEFT 1 RIGHT} [count] 


XEC 


!name 


/name 




!name 


[n] 


±n 




±n.n 





An attention interrupt immediately terminates the current edit command; the editor returns to edit 
command mode. A second attention interrupt without an intervening edit command causes the editor 
to return to MTS. The editor may be reentered by issuing the $EDIT command. 



Edit Mode 29 



MTS 18: The MTS File Editor 
February 1988 



ALTER 
Edit Command Description 



Purpose: 
Prototype: 



Action: 



Modifiers: 



Conditions: 



Examples: 



To replace parts of lines. 

(a) ALTER [lpar] 'stringl'string2' 

(b) ALTER [lpar] 

(c) ALTER [lpar] pattern 

(d) ALTER VAR IABLE=vname pattern 

With prototype (a), the first occurrence of "stringl" in the given line-number 
range "lpar" is replaced by "string2". 

With prototype (b), the strings given in the most recent ALTER command that 
specified strings are used for the replacement. 

Either "stringl" or "string2" may be the null string. If "stringl" is the null 
string, it will match before the first character, in between each character, and 
after the last character in the column range. Unless @RS is specified, the scan 
will resume immediately after the inserted "string2", if @Ais specified. 

With prototype (c), a pattern structure is used to match the line-number range 
"lpar" for the replacement operations. 

With prototype (d), a pattern structure is used to match the value of the variable 
"vname" for the replacement operations. See the section "Pattern Matching" 
for details on using patterns with the editor. 

The action of this command is identical to that of the CHANGE command. 

@A, @AC, @CH, @COL, @LEN, @LNR, @MCL, @OPL, @PA, @PC, @RS, @RTL, 
@TR, @TX, @V, @VMV, @W, @X 

SUCCESS if a replacement is made. EOF if a read beyond the end of the file is 
attempted. 

ALTER 123 'IT' THAT' 

The above command alters the first occurrence of IT in line 123 to THAT. 

ALTER@ALL /FILE ■1984' 1985' 

The above command alters all occurrences in the file of 1984 to 1985. 
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Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Examples: 



APPEND 
Edit Command Description 

To append additional data on the end of lines. 

(a) APPEND [lpar] strexp 

(b) APPEND [lpar] 

With prototype (a), the string specified by the string expression "strexp" is 
appended to the end of all of the lines specified by the line-number range "lpar". 
The PATTERNS option must be ON if "strexp" is more complex than a simple 
string. 

With prototype (b), each line of the given line-number range is printed on the 
terminal and the user is prompted for a string to be appended to that line. If 
the user enters an end-of-file, the command is terminated and the last line 
printed is not modified. 

If the column range starts beyond the end of the line, pad characters are 
inserted from the end of the line up to the beginning of the column range. 

@CH, @COL, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W, @X 

SUCCESS if at least one line is appended. EOF if a read beyond the end of the 
file is attempted. 

APPEND /FILE " " 

The above command appends a blank to the end of every line in the file. 

APPEND@NV@TRIM /FILE " " 
APPEND@NV /FILE COL=35 

The above two commands may be used to document an assembler source 
program. The first APPEND command ensures that all operand fields are 
separated from the comment field by one blank. The second APPEND 
command prints the statement and then prompts for a comment. The 
command will not create a continued statement if the comment extends 
the length of the line beyond column 71. 

APPEND 3 10 DUPL(" ." ,6) 

The above example appends 6 periods to the end of lines 3 through 10. 
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BLANK 
Edit Command Description 



Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Example: 



To blank-out portions of lines. 

(a) BLANK [lpar] strexp 

(b) BLANK [lpar] 

With prototype (a), each line in the given line-number range "lpar" is blanked 
according to the pattern of the string specified by the string expression "strexp", 
i.e., positions in the line corresponding to the current fill character (blank by 
default) in the string are replaced with fill characters; positions in the line 
corresponding to nonfill characters are not changed. The PATTERNS option 
must be ON if "strexp" is more complex than a simple string. 

With prototype (b), each line of the given line-number range is printed on the 
terminal and the user is then prompted for a string to be used as the blanking 
pattern for that line. If the user enters an end-of-file, the command is 
terminated and the last line printed is not modified. 

@CH, @COL, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W, @X 

SUCCESS if at least one line is blanked. EOF if a read beyond the end of the 
file is attempted. 

BLANK 123 "AAA " 

The above command replaces the fourth through the sixth characters of 
line 123 with blanks. 
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CHANGE 
Edit Command Description 



Purpose: 
Prototype: 



Action: 



Modifiers: 



Conditions: 



Example: 



To replace parts of lines. 

(a) CHANGE [lpar] 'stringl'string2' 

(b) CHANGE [lpar] 

(c) CHANGE [lpar] pattern 

(d) CHANGE VARIABLE=vname pattern 

With prototype (a), the first occurrence of "stringl" in the given line-number 
range "lpar" is replaced by "string2". 

With prototype (b), the strings given in the preceding CHANGE command that 
specified strings are used for the replacement. 

Either "stringl" or "string2" may be the null string. If "stringl" is the null 
string, it will match before the first character, in between each character, and 
after the last character in the column range. Unless @RS is specified, the scan 
will resume immediately after the inserted "string2", if @Ais specified. 

With prototype (c), a pattern structure is used to match the line-number range 
"lpar" for the replacement operations. 

With prototype (d), a pattern structure is used to match the value of the variable 
"vname" for the replacement operations. See the section "Pattern Matching" 
for details on using patterns with the editor. 

The action of this command is identical to that of the ALTER command. 

@A, @AC, @CH, @COL, @LEN, @LNR, @MCL, @OPL, @PA, @PC, @RS, @RTL, 
@TR, @TX, @V, @VMV, @W, @X 

SUCCESS if a replacement is made. EOF if a read beyond the end of the file is 
attempted. 

CHANGE 123 'IT' THAT 1 

The above command alters the first occurrence of IT in line 123 to THAT. 
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CHECKPOINT 
Edit Command Description 



Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 



To save the current status of the file so that future editing may be undone back 
to a certain point. 

(a) CHE CKPOINT [ON] 

(b) CHE CKPOINT OFF 

(c) CHE CKPOINT NEVER 

The checkpoint/restore/undo facility provides the capability of establishing a 
base, or checkpoint, from which all or any part of the file may be restored (see 
the section "Checkpoint/Restore Facility"). 

CHECKPOINT ON opens the checkpoint buffer and establishes the current 
status of the file as the checkpoint base. Any previous information in the buffer 
is discarded. Either the RESTORE or UNDO commands may be used later to 
restore the file, or a portion thereof, to this checkpoint base. Issuing the 
CHECKPOINT command without a parameter is synonymous with issuing 
CHECKPOINT ON. Issuing CHECKPOINT ON when CHECKPOINT is 
already enabled provides a new base for RESTORE and UNDO; that is, all 
previous checkpoint information is released. 

CHECKPOINT OFF still opens the checkpoint buffer. How ever, only the 
effects of the last command that changed the file are recorded in the buffer. 
The UNDO command may be used to reverse the action of that command. The 
RESTORE command may be used to restore a subset of the lines that were 
changed by the last command. OFF is the default level of the 
checkpoint/restore facility. 

CHECKPOINT NEVER specifies that no checkpoint information is saved; 
neither the RESTORE nor the UNDO commands have any effect. 

The checkpoint buffer contains the line numbers and original versions of 
modified or deleted lines and line numbers of new lines. This information is 
kept in virtual memory and thus increases the virtual memory storage integral 
and the cost. The user must be aware that a copy of the entire file may reside in 
memory for modifications ranging over the file. It is possible to collect so much 
checkpoint information that no more virtual memory is available, thus 
prohibiting further editing. In such a situation, if the user wishes to restore a 
portion of the file, the NOCHECKPOINT modifier must be used to prevent 
further checkpointing attempts of the RESTORE or UNDO commands. To 
clear the checkpoint information, another CHECKPOINT command must be 
given. 

None. 

SUCCESS if no error messages are generated. 
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CLOSE 
Edit Command Description 



Purpose: 

Prototype: 
Action: 



Modifiers: 
Conditions: 



To force MTS to write the present form of the file to the disk so that in the event 
of a system failure, the chances of losing the modifications made to the file in the 
current editor session are reduced. 

CLOSE 

If the file being edited is a disk file, all of the buffers in memory are written out 
to the disk. The action is the same as that of the MTS WRITEBUF subroutine 
(see MTS Volume 3, System Subroutine Descriptions). 

CLOSE has no effect on checkpoint information; this information remains 
available to the RESTORE and UNDO commands. 

The editor will CLOSE the file whenever a UNLOCK, VUPDATE, or VEXIT edit 
command is executed. Furthermore, whenever an edit command is entered or 
a PF-key is executed, the editor will CLOSE the file if it has not been closed 
within the last 5 minutes. 

None. 

SUCCESS if no error messages are generated. 
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Purpose: 
Prototype: 

Action: 



COLUMN 
Edit Command Description 

To set column limits within which editor commands will perform their actions. 

(a) COL UMN first last 

(b) COLUMN first 

(c) COLUMN 

With prototype (a), the column pointers are set to columns "first" and "last". 
With prototype (b), the column pointers are set to "first" and 32767. With 
prototype (c), the column pointers are set to their initial values, 1 and 32767. 

The column pointers are used by the ALTER, BLANK, CHANGE, MATCH, 
OVERLAY, SCAN, and SHIFT commands as limits for their operations within 
any line of the file. The column range is defined as extending from the 
character pointed to by the first column pointer through that pointed to by the 
second pointer. 



Modifiers: 


None. 


Conditions: 


None. 


Example: 


COLUMN 2 4 



The column pointers are set to columns 2 and 4, respectively. 
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Purpose: 
Prototype: 

Action: 



Modifiers: 

Conditions: 

Example: 



COMMENT 
Edit Command Description 

To print a comment while executing an edit procedure. 

(a) COM MENT 

(b) COM MENT message 

(c) * message 

With prototype (a), no action is taken. 

With prototype (b), the message after the command name is printed if the 
command is executed while processing an edit procedure. 

With prototype (c), the lines are treated as comments. If they are inserted into 
an edit procedure, they will not be printed while processing the procedure 
unless ECHO is ON. This provides a method of internally documenting an edit 
procedure. Note however that all comments are printed if the editor is 
executing in batch mode. 

The PRINT MESSAGE command may also be used to print comments. 

None. 

SUCCESS always. 

COMMENT I have gone this far in the edit procedure 

The message "I have gone this far in the edit procedure" is printed if this 
command is executed within an edit procedure. 
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CONCATENATE 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 

Conditions: 

Example: 



To concatenate several lines into a single line or multiple lines of a specified 
length. 

CON CATENATE [lpar] [LEN=n] 
COMB INE [lpar] [LEN=n] 

All of the lines in the specified region "lpar" are concatenated (combined) into 
one string. The concatenated lines are deleted from the file and the resulting 
string is written into their place. If the length of the string is greater than "n", 
the string is split into sections of length "n" (or less for the last section), and 
these sections are written as individual lines into the file. The default value for 
"n" is the maximum line length for the file (usually 32767). 

Note: Trimming of blanks is never done by this command regardless of the 
setting of the TRIM option. 

COMBINE is a synonym for CONCATENATE. 

@CH, @LEN, @LNR, @MCL, @TX, @V, @VMV, @W 

SUCCESS always. 

CONCATENATE 2 3 LEN=80 

The above command takes all the lines from line 2 to line 3, concatenates 
them into a single string, splits the string into 80-character sections, and 
writes the sections into the region of the file between line 2 and line 3. 
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Purpose: 
Prototype: 



Action: 



Modifiers: 
Conditions: 

Examples: 



COPY 

Edit Command Description 

To copy a set of lines to another part of the file. 

(a) COPY [lpar] [TO] linenumber [COPIES=n] 

(b) COPY [lpar] [COPIES=n] 

(c) COPY [F=FDname [COUNT=n]] [TO] linenumber 
[ COP IES=n] 

(d) COPY [lpar] [TO] F=FDname [COPIES=n] 

With prototype (a), a copy of all of the lines in the line-number range "lpar" is 
inserted at "linenumber". The first line is placed at "linenumber" unless a line 
already exists with that number, in which case the line is inserted immediately 
after it. All copied lines are inserted before the next line following 
"linenumber". The word TO is optional, but caution must be used since 
prototype (a) may be confused with prototype (b). 

With prototype (b), the copied lines are inserted immediately after the current 
line. 

With prototype (c), the lines to be copied are obtained from the file or device 
specified by "FDname". If the COUNT parameter is given, only "n" lines are 
read from "FDname". The file is read with implicit concatenation enabled 
(@IC); the user may override this by specifying FDname@-IC, if implicit 
concatenation is not desired. 

With prototype (d), the lines in "lpar" are copied to the file or device specified by 
"FDname". The beginning line number and increment for the file are as 
specified with "FDname"; hence, it is possible to overwrite existing lines in the 
file. 

The COPY command reads all of the lines to be copied before it writes them. 
Thus it is not possible to duplicate lines by specifying overlapping regions. The 
changes performed by writing to another file or device may not be reversed by 
the RESTORE and UNDO commands. 

If the COPIES keyword is specified, "n" copies of the lines specified will be 
inserted, one copy immediately after the other. 

@CH, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W 

SUCCESS if the region is copied. EOF if a read beyond the end of the file is 
attempted. 

COPY 123 TO 345 

In the above example, a copy of line 123 is inserted at line 345. 
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COPY 123 345 



In the above example, a copy of lines 123 through 345 is inserted between 
the current line and the next line. Note the difference between this 
example and the previous example. 

COPY@NV 1 10 TO 44 

In the above example, a copy of lines 1 through 10 is inserted at line 44. 

COPY F=FILE1 (1,100) TO *L @NV 

In the above example, a copy of lines 1 through 100 of the file FILE1 is 
inserted after the last line in the file. Verification of the copy operation is 
suppressed. 

COPY /FILE TO F=*PRINT* 

In the above example, the entire file is copied to *PRINT* for printing on a 
line printer. 

COPY 1 10 TO 15 COPIES=3 

In the above example, three copies of lines 1 through 10 will be inserted 
after line 15. 

COPY 1 10 TO F=FILE2 (*L+1) 

In the above example, lines 1 through 10 are copied to the end of the file 
FILE2. Note that if the FDname had been specified as F=FILE2(*L), the 
last line of the file FILE2 would have been overwritten by line 1 of the edit 
file. 
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CORRECT 
Edit Command Description 



Purpose: 
Prototype: 

Action: 



To correct parts of lines. 

(a) COR RECT [lpar] strexp 

(b) CORRECT [lpar] 

With prototype (a), each line in the given line-number range "lpar" is corrected 
according to the correction string specified by the string expression "strexp". 
The PATTERNS option must be ON if "strexp" is more complex than a simple 
string. 

With prototype (b), each line in the given line-number range "lpar" is printed on 
the terminal, and the user is prompted for the correction string. The correction 
string is used to correct the line. The corrected line is then printed on the 
terminal for further corrections. When a null string (i.e., an input line of length 
zero) is entered, the next line in the line-number range is printed and the 
process repeated for that line. Entering an end-of-file is the same as entering a 
null string. 

The correction string allows deletion, insertion, replacement, splitting, 
blanking, replacement with editor pad characters, replacement with editor fill 
characters, and truncation. The CORRECT single-character commands D, I, 
R, S, B, P, F, and T are used in the correction string to specify these operations. 
Each of these commands is described below. The fill character (defaults to 
blank) is used in the correction string to indicate that nothing is to be done to the 
corresponding character in the line being corrected. The remainder of the 
correction string following an I, R, or T CORRECT single-character command is 
used as text by the command, and is not scanned for further commands. 

Setting the editor fill character to B, D, F, I, L, P, R, S, T, or U (or a lowercase 
equivalent) is not recommended. In a correction string for prototype (b) read in 
batch mode, the last character that is not a fill character is taken to be the end of 
the correction string (see the description of I, R, and T below). A line containing 
only fill characters is therefore treated as a null line in batch. 

The correction string is examined one character at a time. The action specified 
by this CORRECT single-character command is applied to the current character 
in the line being corrected. The next character in the line being corrected now 
becomes the current character, and the process is repeated until no more 
characters remain in the correction string. 

The CORRECT command only works within the current column range. If a 
CORRECT command is entered outside the current column range, an error 
message is printed. Expansion of a line within the current column range may 
cause truncation on the right within the current column range. Contraction 
within the current column range causes one editor pad character to be appended 
on the right within the current column range for each character removed. 
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When an error is detected, the line remains uncorrected by the current 
correction string. With prototype (a), execution of the CORRECT command 
ceases immediately. With prototype (b), the current line is printed again and 
the user is prompted for a new correction string. 

The actions corresponding to each of the CORRECT single-character commands 
are as follows: 

fill No change is made to the current character in the line. 

B The current character in the line is changed to a blank. 

D The current character in the line is deleted, and any text to the right 
(within the current column range) is shifted left one position. An 
editor pad character is placed in the vacated position at the 
right-hand side of the current column range. Note: This pad 
character is only added if there is at least one character to the right of 
the current column range in the original line. 

F The current character in the line is changed to the editor fill 
character. 

I All text in the correction string following the I is inserted prior to the 
current character in the line. The current character and all 
characters to its right in the line are shifted right as required. 
Characters shifted out of the current column range are lost. Note: 
When using prototype (b) in batch mode, the last character in the 
correction string that is not an editor fill character is taken to be the 
end of the string. 

L The current character in the line is translated to lowercase. 

P The current character in the line is changed to the editor pad 
character. 

R All text in the correction string following the R is used to replace the 
current and following characters in the line, on a one-for-one basis. 
This is done until the end of text in the string. If the replacement 
text extends beyond the current column range, a message is printed 
and the line is unchanged. If the replacement starts beyond the end 
of text in the line, the line is extended as required with pad 
characters. Note: When using prototype (b) in batch mode, the last 
character in the correction string that is not an editor fill character is 
taken to be the end of the string. 

S All text in the line beginning with the character corresponding to the 
S is deleted from the current line and is placed on a new line 
immediately following the current line (the line is split). 

T All text in the line beginning with the character corresponding to the 
T is deleted (the line is truncated). Then all text in the correction 
string following the T is inserted where the truncation began. Note: 
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Modifiers: 
Conditions: 

Examples: 



When using prototype (b) in batch mode, the last character in the 
correction string that is not an editor fill character is taken to be the 
end of the string. 

U The current character in the line is translated to uppercase. 

@CH, @COL, @LEN, @LNR, @MCL, @OPL, @TR, @TX, @V, @W, @X 

SUCCESS if the region is corrected. EOF if a read beyond end-of-file is 
attempted. 

In the following examples, it is assumed that the editor fill and pad characters 
are both blank, and the current column range is at its default value of 1 through 
32767. 

CORRECT 10 "DDDF" 

This deletes the first three characters in the current column range of line 
10, and changes the fourth character to the fill character (i.e., a blank for 
this example). 

CORRECT 10 20 ■ PPPP' 

This changes the first four characters in the current column range to pad 
characters (i.e., a blank for this example) in lines 10 through 20, inclusive. 

CORRECT *F 300 'B B B DBD D' 

This changes the first, third, fifth, and eighth characters in the current 
column range to blanks, and deletes the seventh, ninth, and eleventh 
characters, in all lines between the first line and line 300, inclusive. All 
other characters remain unchanged. 

CORRECT@X /FILE ' C4C440D9B0B0B0B0 ' 



This, in hexadecimal mode, deletes the first two characters in the current 
column range for all lines in the file, leaves the next character unchanged, 
and replaces the next four characters with the character represented by 
hexadecimal 'B0'. 

CORRECT 100# 
THIS LINE CONTAINSSERORS 

B IR# 
THIS LINE CONTAINS ERRORS 

I NO# 
THIS LINE CONTAINS NO ERRORS 
?# 

100 THIS LINE CONTAINS NO ERRORS 



In the above example, the position at which the user enters the RETURN 
(end-of-line) character is significant. The "#" indicates where the user 
enters RETURN. The user does not type the "#" character. 
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Notes: The initial editor fill and pad characters are blank. They may be changed with 

the FILLCHAR and PADCHAR options of the SET edit command. 

The column range may be set with the COLUMN edit command. 

In @X mode, the CORRECT single-character commands and the fill character 
must also be in hexadecimal. 

CORRECTing long lines on ASCII-type display terminals using the prototype 
(b) CORRECT command may be impossible (depending where in the line the 
correction is to be made). 
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COUNT 
Edit Command Description 



Purpose: 

Prototype: 

Action: 

Modifiers: 

Conditions: 

Example: 



To count the number of lines between given line numbers. 

COU NT [lpar] 

The number of lines contained in the given line-number range "lpar" is printed. 

None. 

SUCCESS if no error messages are generated. EOF if a read beyond the end of 
the file is attempted. 

COUNT /FILE 

The above command counts the number of lines in the entire file. 
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DELETE 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 
Conditions: 

Examples: 



To remove lines from the file. 

DELETE [lpar] [OK] 

The lines in the given line-number range "lpar" are deleted from the file. The 
line numbers must be specified in ascending order. If the edit file is a 
sequential file, the lines cannot be deleted; however, the lines will be filled with 
blanks so that the data is effectively deleted. The message "Line padded" will 
be printed for each such line. 

The line numbers delimiting the range are checked to ensure that they do not 
point to lines outside the actual bounds of the file. If such is the case, 
confirmation is requested. A reply of OK allows the command to proceed. 
Alternatively, the OK may be appended to the command. If the DV 
(DELETEVERIFY) option is not set to OFF, confirmation is required if more 
than the number of records specified by the DV value are to be deleted. The DV 
value is initially 5. 

If the VERIFY option is ON (the default), a message giving the number of lines 
deleted is printed. 

@CH, @MCL, @V 

SUCCESS if at least one line is deleted. EOF if a read beyond the end of the file 
is attempted. 

DELETE 234.3 

The above command deletes line 234.3 from the file. 

DELETE 300 *L OK 

The above command deletes all lines from line 300 to the end of the file. 
Confirmation is given with the command. 
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Purpose: 
Prototype: 



Action: 



Modifiers: 

Conditions: 

Examples: 



EDIT 
Edit Command Description 

To select another file to be edited. 

(a) ED IT filename [[:]edit-command] 

(b) EDIT {PROCEDURE I XEC} !name [[:]edit-command] 

(c) EDIT VPF pfname [[:]edit-command] 

(d) EDIT MACRO macro-name [[ :]edit-command] 

With prototype (a), "filename" becomes the new file to be edited. 

With prototype (b), the edit procedure "!name" becomes the "file" to be edited. 
The full facilities of the editor are available when editing an edit procedure. 

With prototype (c), the visual-mode program-function cluster becomes the file to 
be edited. See the description of the VPF visual-mode command for details of 
using program-function clusters. 

With prototype (d), the MTS command macro "macro-name" becomes the "file" 
to be edited. Note: This is valid only if the command $SET MACROS=ON has 
been given and the macro has been defined. 

An optional colon and edit command may be appended to EDIT command. This 
command will be executed immediately after the edit file has been changed. 

The current line (*) is set to the first line of the new edit file. 

Any checkpoint information that has been saved for the previous file is 
discarded, and new checkpoint information is accumulated for the new file being 
edited. See the CHECKPOINT, RESTORE, and UNDO commands for further 
description of the checkpoint facility. 

None. 

SUCCESS if no error messages are generated. 

EDIT MYFILE 

In the above example, the file MYFILE becomes the edit file. 

EDIT PROCEDURE ! PROCB 

In the above example, the edit procedure IPROCB becomes the edit file. 

EDIT MACRO SEND : PRINT /FILE 

The definition of the MTS macro named SEND is printed. 
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Purpose: 
Prototype: 



Action: 



Modifiers: 

Conditions: 

Examples: 



EXECUTE 
Edit Command Description 

To execute an edit procedure, an edit command, or the visual-mode work area. 

(a) EXE CUTE !name n 

(b) EXE CUTE !name 

(c) EXE CUTE 'edit-command' 

(d) EXECUTE ED_WORK 

With prototype (a), the edit procedure "!name" is executed "n" times. 

With prototype (b), the procedure is executed once. 

With prototype (c), the edit command string is executed. 

With prototype (d), the contents of the visual-mode work area is executed. 

Prototypes (c) and (d) are most useful when used within an edit procedure. 
However, edit-command messages such as "Search failed" and "File does not 
exist" will not be printed for commands executed from the procedure. The 
SUCCESS and FAILURE switches may be used to determine the status of the 
command executed (see the section "Edit Procedures" above). 

None. 

SUCCESS if no error messages are generated. 

EXECUTE IPROCB 10 

In the above example, the edit procedure IPROCB is executed 10 times. 

EXECUTE "SCAN 1 10 "ABC" 

In the above example, the SCAN command is executed. 
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EXPLAIN 
Edit Command Description 



Purpose: 
Prototype: 

Action: 

Modifiers: 

Conditions: 

Example: 



To describe editor commands during an editor session. 

(a) EXPLAIN 

(b) EXPLAIN command 

The EXPLAIN command provides information about the syntax and operation 
of editor commands. Prototype (a) provides general editor information. 
Prototype (b) provides information about the specified command. 

None. 

SUCCESS if an explanation is given. 

EXPLAIN ALTER 

The above command provides information about the ALTER command. 
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Purpose: 
Prototype: 



Action: 



Modifiers: 
Examples: 



GOTO 
Edit Command Description 

To alter the flow of execution in an edit procedure. 

(a) GOTO label 

(b) GOTO label [ON] condition 

where "condition" is any of SUCCESS, S, FAILURE, F, ENDOFFILE, 
EOF, or E. 

The GOTO command may used within an edit procedure to alter the sequential 
execution of commands. Prototype (a) specifies an unconditional transfer to 
the edit procedure command with the given label. Prototype (b) specifies a 
transfer if the specified condition is satisfied. 

The label may be one to eight nonblank characters. There are two predefined 
edit procedure labels, COUNT and END. COUNT decrements the execution 
count by one and continues execution from the beginning of the edit procedure if 
the count is still positive. END terminates the edit procedure immediately, 
regardless of the execution count given. 

None. 

GOTO LABELl 

The above command transfers execution to the label LABELl. 

GOTO END ON EOF 

The above command terminates execution when an end-of-file condition 
occurs. 
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INSERT 
Edit Command Description 



Purpose: 
Prototype: 

Action: 



Modifiers: 



To insert new lines into the file. 

(a) INSERT [linenumber] strexp 

(b) INSERT [linenumber] 

(c) INSERT [linenumber] INCREMENT=increment 

With prototype (a), the string specified by the string expression "strexp" is 
inserted as a new line in the file. Its line number becomes "linenumber" unless 
a line already exists with that number, in which case the new line is inserted 
immediately after "linenumber". If no space is available, the comment 

No room left for insertion 

is printed. The PATTERNS option must be ON if "strexp" is more complex 
than a simple string. 

With prototype (b), the user is prompted for lines to be inserted at or after 
"linenumber". This is called "quick insertion mode." The user may enter an 
arbitrary number of lines in this manner. If the user attempts to enter more 
lines than will fit, the above error comment is printed. To leave quick insertion 
mode, a null line or an end-of-file may be given. Implicit concatenation is 
ignored in quick insertion mode. The inserted lines are spaced evenly between 
"linenumber" and the next line following it. The editor accomplishes this by 
periodically renumbering the lines within the insert space. The user need not 
be concerned with this automatic renumbering except when the access to the 
edit file is only WRITE (not WRITE/CHANGE). In this case, the user should 
use prototype (c). 

With prototype (c), the user is prompted for lines to be inserted at or after 
"linenumber". This is an alternate form of prototype (b). The major difference 
between this form and prototype (b) is that the increment between lines is 
explicit, and the user is prompted for lines using the line number which will be 
assigned to the line being inserted. The lines inserted will start at 
"linenumber", if it is not already occupied, and continue with the increment 
given by "increment". If "linenumber" is occupied, the first line will be inserted 
at "linenumber+increment" and insertion will continue from there. Otherwise, 
prototype (c) works in exactly the same way as prototype (b), except that the 
error message given when no more insertions are possible is: 

No more room for insertion with given increment 

The line-number prompting may be disabled by specifying the modifier @NPLN 
or setting the PLN (PAGELINENUMBER) option to OFF. The current line 
pointer is set at the last line inserted. 

@CH, @LEN, @LNR, @PLN, ©MACRO, @MCL, @TR, @TX, @V, @VMV, @W, @X 
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Conditions: 
Examples: 



SUCCESS if at least on line is inserted. 
INSERT 123 'data' 

In the above example, the line "data" is inserted at line 123 in the file. 

INSERT 12 
data 1 
data 2 
data 3 
$ENDFILE 

In the above example, lines "data 1", "data 2", and "data 3" are inserted at 
line 12 of the file, "data 3" is the current line (*). 

INSERT 12 I=.01 
12 _ data 1 

12.01 _ data 2 

12.02 _ data 3 

12.03 _ $ENDFILE 

This example is the same as the previous example except that the lines to 
be inserted are explicitly assigned to line numbers 12, 12.01, and 12.02. 

INSERT 4 ASCII ('Hi There!') 

This example inserts the ASCII character equivalent of the string "Hi 
There!" at line 4. 
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Purpose: 
Prototype: 



Action: 



JUSTIFY 
Edit Command Description 

To right- or left-justify lines. 

JUSTIFY [lrange] [direction lmar rmar] 

where 

"lrange" is a contiguous line range specifying the text to be justified, 
line range must be in the forward order. 



The 



"direction" is a keyword specifying the method of justification to be used. 
The values allowed for "direction" are LEFT, RIGHT, and BOTH. 

"lmar" is the column to be used as the left margin for the justification. 

"rmar" is the column to be used as the right margin for the justification. 

The line range specified by "lrange" will be justified to the columns "lmar" and 
"rmar" on the basis of the keyword "direction". LEFT means justify to the left 
margin (ragged-right), RIGHT means justify to the right margin (ragged-left), 
and BOTH means justify to both margins (block). 

"direction", "lmar", and "rmar" must all be specified if any are specified. If all 
three are omitted, the previous values (i.e., the values appearing on the previous 
JUSTIFY command) will be used. If there was no previous JUSTIFY 
command, the command will be aborted, "lrange" defaults to the current line 
(*). 

At the start of the justification process, the lines in "lrange" are subdivided into 
individual items, with each item being the string of characters up to the next 
editor fill character. The editor fill character is normally a blank, but may be 
redefined by the editor FILLCHAR option. For a block of written text, each 
item is synonymous with a word. After the text has been subdivided into 
individual items, the text is then rewritten into the line range specified by 
"lrange" according to the justification direction and margin specifications, 
replacing the previous unjustified lines. If extra lines are needed to 
accommodate the justified text, they will be inserted after the last line in the 
line-number range. 

If the @OPL modifier is not specified (the default), the justified lines are packed 
as tightly as possible. Certain items may be moved up or down from their 
original lines to the end or beginning of a different line. 

If @OPL is specified, the lines in "lrange" are processed individually, i.e., items 
from one line are not merged with items of another line. Thus, the justification 
is done on a line-by-line basis, rather than over a block of lines. If the original 
line is too long for the justification region, new lines will be created for the excess 
items. 
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Modifiers: 

Conditions: 

Example: 



The space to the left of the left margin "lmar" and the space between individual 
items in each rewritten line is filled with the editor pad character. The editor 
pad character is normally a blank, but may be redefined by the editor 
PADCHAR option. If LEFT or RIGHT is specified, only one pad character is 
inserted between each item. If BOTH is specified, one or more pad characters 
may be inserted between each item. 

If a blank line is encountered in "lrange", it is treated as a request to interrupt 
the current justification process and justify the accumulated items. A blank 
line is written after the justified lines. Justification then resumes with the 
next nonblank line. This provides a method of paragraphing by inserting blank 
lines where paragraph endings are desired. 

If an item longer than the justification region is encountered, it will be rewritten 
as a single line without truncation (thus extending beyond the right margin 
"rmar"). 

An error message is printed if "lmar" > "rmar", or if either is less than 1 or 
greater than the maximum record length of the edit file. An error message is 
also printed if the resultant justified output will not fit in the space occupied by 
"lrange". This may occur if the justification area as defined by "lmar" and 
"rmar" is substantially less than the line lengths of the original text. 

@CH, @LEN, @LNR, @MCL, @OPL, @TR, @TX, @V, @VMV, @W 

SUCCESS if the region is justified. 

JUSTIFY /FILE BOTH 1 65 

In the above example, the contents of the entire edit file is justified 
between columns 1 and 65. 
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Purpose: 

Prototype: 

Action: 



Modifiers: 

Conditions: 

Example: 



LET 
Edit Command Description 

To create or redefine an editor variable. 

LE T variable=value 

The LET command creates or redefines an editor variable. If the variable does 
not exist, it is created and assigned the value "value"; otherwise, the current 
value is replaced by "value". 

Editor variables are useful in the construction of editor pattern structures to 
assign matched substrings, or are used to save complete pattern structures. 

The variable name may consist of 1 to 255 characters, the first of which must be 
alphabetic (A-Z) while subsequent characters may be alphanumeric (A-Z, 0-9, 
and _). The value of the variable may be any one of the following data types: 

(1) an integer, e.g., 5, -4 

(2) a line number, e.g., *F, 1.5 

(3) a string or string expression, e.g., "STRING1", 'string2', ABC 
VARIABLE DEF' 

(4) a pattern 

A variable is not declared to be of a particular data type; the context in which the 
variable is used determines its type. 

The primary use of editor variables is with pattern matching (see the section 
"Pattern Matching"). 

The editor has several predefined variables. These are listed in the section 
"Pattern Matching." 

None. 

SUCCESS if no error messages are generated. 

LET ALPHA= ' abcdef ' 

The above example creates the variable ALPHA with the string value 
"abcdef. 

LET ED_VRULER= ■ ' 

The above example sets the visual-mode ruler to the null string. The 
ruler area will now contain the default status line as specified by the 
variable ED STATUS DEF. 
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Purpose: 
Prototype: 

Action: 



Modifiers: 

Conditions: 

Examples: 



LINE 
Edit Command Description 

To make a particular line the current line. 

(a) LINE [linenumber] 

(b) LINE linenumber increment 

(c) LINE linenumber COUNT=n 

With prototype (a), the line number specified becomes the current line. 

With prototype (b), the values of "linenumber" and "increment" are added to 
form a new line number, which becomes the current line, "increment" is an 
absolute integer value that is added to "linenumber". 

With prototype (c), "n" is a displacement (counting the number of existing lines) 
from "linenumber". The primary use of prototype (c) is to define values for 
program-function keys in visual mode using the line numbers *VT and *VB, 
which represent the top and bottom of the visual screen, respectively. For 
example, the default definitions for several of the program-function keys are: 

PF1 andPF13: LINE *VT COUNT=-10 
PF4 and PF16: LINE *VT COUNT=10 
PF7 and PF19: LINE *VT COUNT=l 

@LEN, @LNR, @TX, @V, @VMV, @W, @X 

SUCCESS if the line is in the file. EOF if the line is not in the file. 

LINE 123 

In the above example, line 123 becomes the current line. 

LINE *L -10 

In the above example, the tenth line from the end of the file becomes the 
current line. 

LINE *VB COUNT=-5 

In the above example, the visual-mode screen will be positioned so that the 
new top line is the fifth line from the bottom of the current screen. 
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MATCH 
Edit Command Description 



Purpose: 
Prototype: 



Action: 



Modifiers: 



Conditions: 



Examples: 



To search for a line with a particular character string starting in a particular 
column. 

(a) MATCH [lpar] 'string' 

(b) MATCH [lpar] 

(c) MATCH [lpar] pattern 

(d) MATCH VAR IABLE=vname pattern 

With prototype (a), the editor searches the given line-number range "lpar" for a 
line that matches "string" starting at the left column position. Positions in the 
string in which the current fill character occurs will match any character in the 
corresponding position in the column range. 

With prototype (b), the most recent string given in a previous MATCH command 
is used. 

With prototype (c), a pattern structure is used to search the line-number range 
"lpar" for the subject string. The fill character is ignored when using prototype 
(c). The pattern match is done in anchored mode. 

With prototype (d), a pattern structure is used to search the value of the variable 
"vname" for the subject string. See the section "Pattern Matching" for details 
on using patterns with the editor. 

If no line-number range is specified, the command searches from the current 
line to the last line in the file (* *L). 

The current line is set to the last line with a successful match. The top of the 
visual-mode screen (*VT) is set to the first line with a successful match. 

The initial fill character is the blank. It may be changed with the editor 
FILLCHAR option. The left column position may be changed by the COLUMN 
command. 

The line or lines that are matched by the MATCH command may be referenced 
collectively by the /MATCH region. 

@A, @AC, @COL, @LEN, @LNR, @MCL, @NOT, @OPL, @PC, @TX, @V, @VMV, 

@w,@x 

SUCCESS if a successful match was made. EOF if the search extends beyond 
the end of the file. 

MATCH@ALL /FILE 'A D 1 

In the above example, the entire file is searched for all occurrences of the 
string "AxxD", where A begins in the leftmost column. The second and 
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third characters are arbitrary. 

MATCH@ALL /TAIL ED_09 "B" 
COPY /MATCH TO F=FILE1 

In the above example, the edit file is searched from the next line after the 
current line to the end of the file for two-character strings that begin with a 
digit and are followed by "B". All of the lines successfully matched are 
copied into the file FILE1 by using the COPY command with the /MATCH 
region. 
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Purpose: 

Prototype: 

Action: 

Modifiers: 

Conditions: 

Example: 
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MCMD 
Edit Command Description 

To execute an MTS command. 

MCMD command 

The MTS command specified is executed and control is returned to edit mode. 

None. 

SUCCESS if the command succeeded. 

MCMD $DISPLAY COST 

In the above example, the $DISPLAY COST command is executed to 
display the current cost of the terminal session. 
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Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Examples: 



MOVE 
Edit Command Description 

To move a set of lines to another part of the file or to another file. 

(a) MOVE [lpar] [TO] linenumber 

(b) MOVE [lpar] 

(c) MOVE [lpar] [TO] F=FDname 

With prototype (a), all of the lines in the line-number range "lpar" are inserted 
at "linenumber" and the lines in the original region "lpar" are deleted. The first 
line is inserted at "linenumber" unless a line already exists with that number, in 
which case the first line is inserted immediately after it. All of the lines are 
inserted before the next line following it. The word TO is optional, but caution 
must be used since prototype (a) may be confused with prototype (b). 

With prototype (b), the moved lines are inserted immediately after the current 
line. 

With prototype (c), the lines in "lpar" are moved to the FDname specified. 

The MOVE command reads all of the lines to be moved before it writes them; 
thus, it is not possible to cause loops by specifying overlapping regions. The 
changes performed by writing to another file or device may not be reversed by 
the UNDO or RESTORE commands. 

Changes to the external file cannot be undone. However, the UNDO command 
will place lines back into the edit file. 

@CH, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W, @X 

SUCCESS if the region is moved. EOF if the line-number range extends 
beyond the end of the file. 

MOVE 6 TO 2 

In the above example, line 6 is inserted at line 2. 

MOVE 4 9 *L 

In the above example, lines 4 through 9 are appended to the end of the file. 
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Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Example: 



MTS 
Edit Command Description 

To return to the caller (normally MTS command mode). 

(a) MT S 

(b) MT S command 

With prototype (a), control returns to the caller (normally MTS command mode). 

With prototype (b), control returns to the caller (normally MTS command mode) 
and the command specified is executed as an MTS command. 

The edit session may be later resumed by issuing the $EDIT command. 

If a patterned file name was specified on the EDIT command, the next file in the 
pattern sequence (if any) is edited. 

None. 

SUCCESS always for prototype (a); SUCCESS for prototype (b) if the command 
succeeded. 

MTS $DISPLAY COST 

In the above example, control returns to MTS command mode and the cost 
of the terminal session is displayed. 
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Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Examples: 



OVERLAY 
Edit Command Description 

To overlay certain portions of a line with other data. 

(a) OVERLAY [lpar] strexp 

(b) OVERLAY [lpar] 

With prototype (a), each line in the specified line-number range "lpar" is 
overlaid with the string specified by the string expression "strexp". The 
PATTERNS option must be ON if "strexp" is more complex than a simple string. 

With prototype (b), each line is printed on the terminal and the user is prompted 
for a string to be overlaid on that line. If the user enters an end-of-file, the 
command is terminated and the last line printed is not modified. 

Positions in the line corresponding to a nonfill character in the string are 
replaced by the corresponding character in the string; positions corresponding 
to a fill character are not changed. The overlaying is done with respect to the 
current column range. 

If the columns being overlaid extend beyond the end of the line, pad characters 
are inserted from the end of the line to the right column pointer. 

The initial fill character is the blank. It may be changed with the editor 
FILLCHAR option. The current column range may be changed by the 
COLUMN command. 

@CH, @COL, @LEN, @LNR, @MCL, @TR @TX, @V, @VMV, @W, @X 

SUCCESS if at least one line is overlayed. EOF if a read beyond the end of the 
file is attempted. 

OVERLAY 123 '0000' 

In the above example, the first four characters of the current column range 
(as set by the COLUMN command) in line 123 are overlaid with zeros. 



OVERLAY 123 ' 



ABC 



In the above example, the fourth through sixth characters of the current 
column range (as set by the COLUMN command) in line 123 are replaced 
by the string ABC; the first three characters are unchanged. 



OVERLAY 19 COL=35 "comment' 



In the above example, the seven characters in line 19 starting at column 35 
are replaced by the string "comment". If line 19 is less than 34 characters 
in length, it will be padded to 34 characters with the pad character, and the 
string will be appended at column 35. 
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Purpose: 
Prototype: 



Action: 



PRINT 
Edit Command Description 

To print lines of the file or information about editor variables and options. 

(a) PRINT [lpar] 

(b) PRINT [lpar] CHECKPOINT 

(c) PRINT COL UMNS 

(d) PRINT FILENAME 

(e) PRINT { MES SAGE I MSG} strexp 

(f) PRINT !name 

(g) PRINT {PROCEDURES I XECS} 
(h) PRINT REG IONS 

(i) PRINT SAVES 

(j) PRINT VARS 

(k) PRINT VAR IABLE name 

(1) PRINT VMSG strexp 

(m) PRINT VPFS 

(n) PRINT WINDOWS 

With prototype (a), all of the lines in the given line-number range "lpar" are 
printed. 

With prototype (b), all of the lines in the given line-number range that have been 
changed since the last CHECKPOINT command are printed. 

PRINT COLUMNS prints the values of the column pointers. 

PRINT FILENAME prints the name of the file being edited. 

PRINT MESSAGE or PRINT MSG prints the message given by "strexp". 
"strexp" may be a character string, a variable, or a combination of character 
strings and variables. If the command is executed in visual mode, the message 
will be intensified and placed in the ruler area (immediately below the work 
area); the VMV modifier must be used to write the message into the 
conversation buffer. 

PRINT !name prints the commands of the edit procedure "!name". 

PRINT PROCEDURES or PRINT XECS prints the names of the currently 
defined edit procedures. 

PRINT REGIONS prints the names of the currently defined regions. The 
"/name" command may be used to print region values. 

PRINT SAVES prints the names of all files that have been SAVEd along with 
their associated save names. 

PRINT VARIABLE name prints the name, type, length, and value of the editor 
variable "name". 
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Modifiers: 
Conditions: 

Examples: 



PRINT VARS prints the names of all editor variables that are currently defined. 

PRINT VMSG prints the message given by "strexp" in the visual-mode error 
comment field below the vruler/status line. This allows, for example, a 
command macro to issue messages that will appear at the bottom of the visual 
screen and then enter visual mode. 

PRINT VPFS prints the current definitions of all the visual-mode 
program-function keys. 

PRINT WINDOWS prints the values of the window pointers. 

@LEN, @LNR, @MCL, @TX, @VMV, @W, @X 

SUCCESS if the information is printed. EOF if a read beyond the end of the file 
is attempted. 

PRINT 123 

In the above example, line 123 is printed. 

PRINT /FILE CHECKPOINT 

In the above example, all lines in the entire file that have been changed 
since the last CHECKPOINT command was issued are printed. 

PRINT MSG "Did you know that this is a " WHAT 

In the above example, the message "Did you know that this is a test" is 
printed assuming that the value of variable WHAT is "test". 
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PROCEDURE 
Edit Command Description 



Purpose: 
Prototype: 

Action: 



Modifiers: 



Conditions: 
Examples: 



To create an edit procedure. 

PRO CEDURE !name 
XEC !name 

An edit procedure with the name "!name" is created, or emptied if it already 
exists. 

The user is prompted to enter the command list. All edit commands entered 
become part of the command list. The command list is terminated by entering 
the pseudocommand END, a null line, or an end-of-file. 

XEC is an alternate command name for PROCEDURE. 

See the section "Edit Procedures" for further details. 

©MACRO 

If the ©MACRO is specified, lines read during the procedure definition are read 
with the MTS FDname @MA CRO@MFR applied (any line beginning with the 
MTS command macro flag ">" will be processed by the MTS macro processor). 

None. 

PROCEDURE IPROCl 

LINE@NV *F 

LOOP: SCAN ' TENTATIVE '@NV 

GOTO END ON FAILURE 

DELETEONV 

GOTO LOOP 

END 

In the above example, the edit procedure 1PROC1 is created which deletes 
from the entire file all lines containing the string "TENTATIVE". 

PROCEDURE@MACRO ! SETUP 

>Set_Edit 

END 

In the above example, the MTS command macro named Set_Edit is used to 
define the edit procedure ! SETUP. 
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REGION 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 

Conditions: 

Examples: 



To define names which refer to certain sets of lines within the file. 

REG ION /name lpar 

The REGION command defines the region name "/name" to be the line-number 
range "lpar". 

"lpar" may consist of one or more previously defined region names. In this case, 
the region are concatenated to form the new region. Overlap may occur, e.g., 
the commands 

REGION /REGl 1,2 
REGION /REG2 2,3 
REGION /REG3 /REG1,/REG2 

will define a region REG3 which contains two occurrences of line 2. 

The line numbers defining a region can be displayed by using the "/name" 
command, e.g., 

/REGl 

None. 

SUCCESS if the region is created. 

REGION /REGl 100 200 

The region name /REGl is defined as the line-number range 100 to 200. 

REGION /REG2 100,200 

/REG2 is defined as a region consisting of two lines, 100 and 200. 
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REMEMBER 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 
Conditions: 



To restore a previous state of the edit session. 

REM EMBER [name] 

Information saved under "name" by the SAVE command is restored causing the 
editor to revert to that state. 

If "name" is omitted, the save information named by the current file name is 
used. 

See also the SET REMEMBER, SET SAVE, and SET SAVEREMEMBER 
descriptions. 

None 

None 
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Purpose: 
Prototype: 



Action: 



Modifiers: 

Conditions: 

Examples: 



RENUMBER 
Edit Command Description 

To renumber lines in the file. 

(a) REN UMBER [first last beg inc] 

(b) REN UMBER beg inc 

(c) REN UMBER first last beg 

(d) REN UMBER beg 

The lines in the region "first" through "last" are renumbered to have line 
numbers beginning with "beg" and successively incremented by "inc". 

The defaults are: first=*F, last=*L, beg=l, and inc=l. 

None. 

SUCCESS if the region is renumbered. 

RENUMBER 1 100 1 

The above command renumbers lines 1 through 100 of the file beginning 
with 1 and incremented by 1. 

RENUMBER 1000 10 

The above command renumbers the entire file beginning with 1000 and 
incremented by 10. 

RENUMBER 1 

The above command renumbers the entire file beginning with 1. 
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REPLACE 
Edit Command Description 



Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Examples: 



To replace lines in the file. 

(a) REPLACE [lpar] strexp 

(b) REPLACE [lpar] 

With prototype (a), each line within the line-number range "lpar" is replaced by 
the string specified by the string expression "strexp". The PATTERNS option 
must be ON if "strexp" is more complex than a simple string. 

With prototype (b), each line is printed on the terminal and the user is prompted 
for a string to be used as a replacement for that line. If the user enters an 
end-of-file, the command is terminated and the last line printed is not modified. 
If the user enters a null line, the line is replaced by a null line; i.e., it is deleted. 

@CH, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W, @X 

SUCCESS if at least one line is replaced. EOF if a read beyond the end of the 
file is attempted. 

REPLACE 123 'newline' 

In the above example, line 123 is replaced by the string "newline". 

REPLACE 123 
newline 

In the above example, line 123 is replaced by the string "newline". 

REPLACE 1 10 RPADpB' ED_09,16) '*' 

The above example replaces lines 1 through 10 with lines containing the 
string "B0123456789 
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Purpose: 

Prototype: 

Action: 



Modifiers: 

Conditions: 

Examples: 



RESTORE 
Edit Command Description 

To restore the status of the file to the point of the last CHECKPOINT command. 

RESTORE [lpar] 

The RESTORE command restores the portion of the file specified by "lpar" to its 
condition at the last CHECKPOINT ON command, if checkpointing is enabled. 
The specified portion of the file is restored to its status before the last command 
that changed it, if CHECKPOINT is OFF (the default). The RESTORE 
command has no effect if CHECKPOINT is NEVER. 

If "lpar" is omitted, only the current line is restored. To restore the entire file, 
/FILE should be specified. The COUNT keyword in "lpar" is not allowed with 
this command. 

See the section "Checkpoint/Restore Facility" for further details. 

@CH, @LEN, @LNR, @TR, @TX, @V, @VMV, @W, @X 

None. 

RESTORE 123 

In the above example, line 123 is restored to its status at the last 
CHECKPOINT command. 

RESTORE /FILE 

In the above example, the entire file is restored to its status at the last 
CHECKPOINT command. 
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RETURN 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 
Conditions: 



To return to the caller (normally MTS command mode). 

RETURN 

Control returns to the caller (normally MTS command mode). 

The edit session may be later resumed by issuing the $EDIT command. 

If a patterned file name was specified on the EDIT command, the next file in the 
pattern sequence (if any) is edited. 

Note: Many terminals have a RETURN key; pressing this key is not equivalent 
to typing the characters "RETURN". 

None. 

SUCCESS always. 
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SAVE 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 
Conditions: 



To save information about the current state of the edit session. 

SAV E [name] 

Information about the current state of the edit session (*VT, current line, 
insertion point and count, etc.) is saved under "name". 

If "name" is omitted, the saved information is named with the current file name. 

Note that this command does not save any text from the file. The 
CHECKPOINT command must be used for this purpose. 

Any regions that are defined and/or any checkpoint information is lost when a 
new file is edited, even though the current file may have been saved. 

See also the SET REMEMBER, SET SAVE, and SET SAVEREMEMBER 
descriptions. 

None 

None 
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Purpose: 
Prototype: 



Action: 



Modifiers: 



Conditions: 



Examples: 



SCAN 
Edit Command Description 

To search for a line containing a particular character string. 

(a) SCAN [lpar] 'string' 

(b) SCAN [lpar] 

(c) SCAN [lpar] pattern 

(d) SCAN VAR IABLE=vname pattern 

With prototype (a), each line in the given line-number range "lpar" is searched 
for the first occurrence of the character string "string". 

With prototype (b), each line is searched for the first occurrence of the character 
string given on the last SCAN command that specified a string. 

With prototype (c), a pattern structure is used to search the line-number range 
"lpar" for the subject string. The pattern match is done in unanchored mode. 

With prototype (d), a pattern structure is used to search the value of the variable 
"vname" for the subject string. See the section "Pattern Matching" for details 
on using patterns with the editor. 

If no line-number range is specified, the command searches from the current 
line to the last line of the file (* *L). 

The current line is set to the last line in which there was a successful match. 
The top of the visual-mode screen (*VT) is set to the first line with a successful 
match. 

The line or lines that are matched by the SCAN command may be referenced 
collectively by the /SCAN region. 

@A, @AC, @COL, @LEN, @LNR, @MCL, @NOT, @OPL, @PC, @RTL, @TX, @V, 
@VMV, @W, @X 

SUCCESS if the search is successful. EOF if a read beyond the end of the file is 
attempted. 

SCAN /FILE 'TIGER' 

In the above example, the entire file is searched for the first occurrence of 
the string "TIGER". 

SCAN@ALL 1 100 'B' LEN(2) 'B' 
MOVE /SCAN TO *L 

In the above example, lines 1 through 100 are scanned for the pattern 
"BxxB", where "xx" is arbitrary. All the lines matching that pattern are 
moved to the end of the file by using the MOVE command with the /SCAN 
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SET 
Edit Command Description 

Purpose: To change the settings of global editor options. 

Prototype: SE T keyword=value ... 

Action: The SET command is used to alter the values of a number of global editor 

options that govern the editing process. 

{AC I ANYCASE}={ON I OFF} Default: OFF 

If the ANYCASE option is ON, the ALTER, CHANGE, MATCH, and 
SCAN commands will match any occurrence of alphabetic characters in 
the pattern regardless of case. If the ANYCASE option is OFF, these 
commands will match only the exact alphabetic characters as specified in 
the pattern. 

ALL={ON I OFF} Default: OFF 

If the ALL option is ON, the ALTER, CHANGE, MATCH, and SCAN 
commands process all occurrences of the pattern throughout the specified 
range of the file. If the ALL option is OFF, these commands process only 
the first occurrence of the pattern. 

BASE=[n] Default: 0.0 

The line number to be used as line 0.0 in edit commands and editor output. 
The base does not affect MINLINE or MAXLINE. If "n" is omitted, the 
base is reset to the default. 

CHECKPOINT={ON I OFF} Default: ON 

If the CHECKPOINT option is ON and if the checkpoint buffer has been 
opened by the CHECKPOINT command, the results of edit commands are 
recorded in the buffer so that they may be undone, if necessary. See the 
section "Checkpoint/Restore Facility." 

COLUMN={ON I OFF} Default: ON 

If the COLUMN option is ON, the action of the edit command applies only 
to the column range set by the COLUMN command. See the description 
of the COLUMN command. 

{DV I DELETEVERIFY}={n I OFF} Default: 5 

The DELETEVERIFY option specifies the maximum number of lines to be 
deleted without confirmation by the DELETE command. This safeguards 
the user against the accidental deletion of a larger number of lines than 
intended. This number may be set to any positive integer. Requests for 
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confirmation may be suppressed by setting DELETEVERIFY to OFF. 

{E I ECHO}={ON I OFF} Default: OFF (terminal) 

ON (batch) 

If the ECHO option is ON, edit commands are echoed (printed) as they are 
executed. 

{ERR I ERROREXIT}={ON I OFF} Default: OFF (terminal) 

ON (batch) 

If the ERROREXIT option is ON, the edit session is terminated if an error 
occurs. The editor may be reentered by issuing another $EDIT command. 

{F I FILL I FILLCHAR}=char Default: blank 

The fill character may be set to any single character. The fill character is 
used by the BLANK, JUSTIFY, MATCH, and OVERLAY commands. 

{HEX I HEXADECIMAL I X}={ON I OFF} 

Default: OFF 

If the HEXADECIMAL option is ON, all character strings given in the 
command are treated as hexadecimal strings. For example, the string 

"C8C5D3D3D640E3C8C5D9C5" 

is equivalent to 

"HELLO THERE" 

when this option is ON. Verification is printed in hexadecimal. This 
command is also effective in visual mode. 

LC={ON I OFF} Default: ON 

If the LC option is ON, input text entered on the screen in visual mode will 
not be converted to uppercase. If the LC option is OFF, input text is 
converted to uppercase. This command applies only to the IBM 3278 
terminal. 

{LEN I LENGTH}={ON I OFF} Default: OFF 

If the LENGTH option is ON, verification of a line includes its length. 

{LNR I LINENUMBER}={ON I OFF} Default: ON 

If the LINENUMBER option is ON, verification of a line includes its line 
number. 

MAXLINE[=n] Default: 2147483.647 
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The maximum line number to be accessed in the file. Lines may not be 
read, modified, or inserted above this line number. If "n" is omitted, the 
maximum line number is reset to the default. 

{MCL I MOVECURRENTLINE}={ON I OFF} 

Default: ON 

If the MOVECURRENTLINE option is ON, the current-line pointer (*) is 
moved by the action of edit commands. 

MINLINE[=n] Default: -2147483.648 

The minimum line number to be accessed in the file. Lines may not be 
read, modified, or inserted below this line number. If "n" is omitted, the 
minimum line number is reset to the default. 

NOT={ON I OFF} Default: OFF 

If the NOT option is ON, the pattern search in the SCAN and MATCH 
commands is successful when the pattern is not found. That is, the search 
succeeds at any position in the line where the pattern string fails to match. 
For example, this function in conjunction with the COLUMN command 
may be useful in finding a line that does not contain a blank in a given 
column range. 

{NPP I NONPRINTPROTECT}={ON I OFF} 

Default: ON 

If the NONPRINTPROTECT option is ON, intensified lines will not be 
modifiable when in visual mode. These are lines containing nonprintable 
characters, lowercase letters when LC=OFF, or the last line of the screen 
when truncated. 

{OPL I ONCEPERLINE}={ON I OFF} Default: OFF 

If the ONCEPERLINE option is ON, only one operation such as an 
alteration or successful scan is allowed per line. The setting of 
ONCEPERLINE to ON often implies the setting of the ALL option to ON. 

{P I PAD I PADCHAR}=char Default: blank 

The pad character may be set to any single character. The pad character 
is used by the APPEND, BLANK, JUSTIFY, OVERLAY, and SHIFT 
commands. 

{PA I PRINTALL}={ON I OFF} Default: OFF 

If the PRINTALL option is ON, verification of every alteration of a line is 
given when both the ALL and VERIFY options are ON. If this option is 
OFF, only one verification is printed per line regardless of the number of 
alterations made. The PRINTALL option only applies to the ALTER and 
CHANGE commands. 
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PATTERNS={ON I OFF} Default: OFF 

If the PATTERNS option is ON, the pattern-matching facility is enabled. 
See the section "Pattern Matching" for a description of this facility. 

{PC I PRINTCOLUMN={ON I OFF} Default: OFF 

If the PRINTCOLUMN option is ON, the column number of any successful 
pattern search is printed. In visual mode, the column number is printed 
in the ruler area. 

{PLN I PREFIXLINENUMBER}={ON I OFF} 

Default: ON 

If the PREFIXLINENUMBER option is ON and an increment has been 
specified on the INSERT command, the user will be prompted for insertion 
lines with the line numbers at which the lines are to be inserted. 

{PMAR I PRINTMARGIN}=n 

The PRINTMARGIN option specifies the right print margin. When 
verification is performed, lines exceeding the right print margin are 
continued on the next line with a minus sign prefix character. The default 
right print margin is set on initial entry to the editor and is equal to the 
*SINK* output length. The margin may be reset to an integer value in 
the range of 32 to 255. 

REMEMBER={ON I OFF} Default: OFF 

If the REMEMBER option is ON, an editor remember operation is 
automatically done when returning to edit a file on which a save operation 
was done. See the SAVE and REMEMBER commands for further 
information. 

REPSCAN={ON I OFF} Default: OFF 

If the REPSCAN option is ON, replacement scanning will be performed by 
edit commands. The variables which are to have their values inserted 
must be enclosed by the replacement-scan delimiters (see the 
RPSCDELIM option). 

RPSCDELIM=c 1 c 2 Default: None 

1 o 

"c " and "c " specify the replacement-scan delimiters which are used to 
enclose the variables that are to have their values replaced in a pattern, 
"c " and "c " must be different characters, e.g., { and }. 

RPSCECHO={ON I OFF} Default: ON 

If the RPSCECHO option is ON, the results of each replacement scan 
operation will be echoed. 



78 SET Edit Command 



MTS 18: The MTS File Editor 
February 1988 



{RS I RESCAN}={ON I OFF} Default: OFF 

If both the RESCAN and ALL options are ON, the ALTER and CHANGE 
commands resume pattern scanning at the replaced string (rather than 
after it) after a successful alteration. If these options are ON or if they are 
issued as command modifiers, accidental infinite loops may be created. 
For example, 

ALTER@A@RS 123 "the" then" 

would cause the following line: 
Farmer in the dell 

to become: 

Farmer in thennnnnnnnnnnnnnn . . . 

To limit accidental loops, the rescan count at the same column position is 
limited to a number equal to the maximum possible length of the line. 
One useful purpose for this feature is altering strings of blanks to one 
blank: 

ALTER@A@RS /FILE 

where all pairs of blanks are changed to a single blank. 

{RTL I RIGHTTOLEFT}={ON I OFF} Default: OFF 

If the RIGHTTOLEFT option is ON, pattern scanning is performed from 
right to left within a line, i.e., the last occurrence of the pattern in the line 
is matched first. 

SAVE={ON I OFF} Default: OFF 

If the SAVE option is ON, an editor save operation is automatically done 
when exiting the editor or when the EDIT command is used to edit a new 
file. See the SAVE and REMEMBER commands for further information. 

{SAVEREM I SAVEREMEMBER}={ON I OFF} 

Default: OFF 

If the SAVEREMEMBER option is ON, an editor save operation is 
automatically done when exiting the editor or when the EDIT command is 
used to edit a new file. Similarly, an automatic remember operation is 
done when returning to edit a file on which a save operation was done. 
See the SAVE and REMEMBER commands for further information. 

SPELLCOR={ON I OFF} Default: OFF 

If the SPELLCOR option is ON, the editor will perform spelling correction 
on edit commands in the same manner as spelling correction is performed 
on MTS commands. If the SPELLCOR option is OFF, spelling correction 



SET Edit Command 79 



MTS 18: The MTS File Editor 
February 1988 



is not performed. 

STOP={ON I OFF} Default: ON 

If the STOP option is OFF, the execution of the edit STOP command or an 
end-of-file while reading a command is treated as the edit RETURN 
command. If the STOP option is ON, the editing session is terminated in 
the above situations. 

TIMEINTERVAL={n I OFF} Default: 3 seconds 

If the TIMEINTERVAL option is enabled, the editor will print a warning 
message after every "n" seconds of CPU time have been used for a single 
edit command. If TIMEINTERVAL is OFF, the warning message will be 
suppressed, "n" must be > 0. 

TRIM={ON I OFF} Default: OFF 

If the TRIM option is ON, all lines written or changed in the file are 
trimmed to remove all but one trailing blank. 

{TX I TEXT I LINETEXT}={ON I OFF} Default: ON 

If the TEXT option is ON, verification of a line includes its contents. 

VERIFY={ON I OFF} Default: ON 

If the VERIFY option is ON, the resulting lines are printed after they are 
processed by an edit command. The following options govern the output 
produced by verification: LENGTH, LNR, PA, TEXT, WINDOW, and X. 

VISUAL={ON I OFF} Default: OFF 

If the VISUAL option is ON, the editor will be entered in visual mode 
instead of line mode. This is the same as if the VISUAL command were 
appended to the EDIT command. 

VMARKER={ON I OFF} Default: OFF 

If the VMARKER option is ON, the current line (in visual mode) will be 
marked by adding as asterisk and highlighting the number field. 

VMCOST={ON I OFF I NONE} Default: ON 

If the VMCOST option is ON, the cost of the edit session is given in the cost 
field of the work area when in visual mode. Setting this option to OFF 
may be useful when using the command field of the work area to reposition 
the file to lines with large line numbers. When this option is OFF, a colon 
will separate the cost and work fields. When this option is NONE, the 
separating colon is omitted. 
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VML={ON I OFF I NONE} Default: ON 

If the VML option is ON, line numbers are displayed in visual mode to the 
left of the text. If this option is OFF, periods will appear in place of line 
numbers. If this option is NONE, the line-number field is omitted. 

{VMV I VISUALMODEVERIFY}={ON I OFF} 

Default: OFF 

If the VMV option is ON, verification of commands executed from the work 
area in visual mode will appear in the conversation buffer, i.e., when visual 
mode is exited, the verification will appear on the screen. 

WINDOW={ON I OFF} Default: ON 

If the WINDOW option is ON, the text of lines printed during verification 
includes only those columns specified by the WINDOW command. 



Modifiers: None. 

Conditions: None. 

Example: set verify=on fillchar=$ 



The above SET command sets the VERIFY option to ON and the fill 
character to "$". 
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Purpose: 
Prototype: 

Action: 



Modifiers: 
Conditions: 

Examples: 



SHIFT 
Edit Command Description 

To shift parts of a line to the left or the right. 

SHIFT [lpar] direction count 

where "direction" is LEFT, L, RIGHT, or R and "count" is an integer. 

The SHIFT command shifts the contents of the current column range in the 
given line-number range "lpar" in the specified direction by "count" characters. 
For a right shift, the pad character is inserted into the vacated positions. For a 
left shift, the pad character is inserted into the vacated positions if the line 
extends beyond the left column pointer. If the line does not extend beyond the 
left column pointer, the shift is suppressed for that line. Characters that are 
shifted out of the current column range are lost. 

@CH, @COL, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W 

SUCCESS if at least one line is shifted. EOF if a read beyond the end of the file 
is attempted. 

SHIFT /FILE LEFT 9 

In the above example, every line of the file is shifted to the left by 9 
positions. If the current column range is 1 to 32767, then the first 9 
columns of the file are removed. 

SHIFT /FILE COL=(12,16) RIGHT 2 

In the above example, the characters in columns 12 through 16 of every 
line of the file are shifted to the right by two column positions. Columns 
12 and 13 are filled with the pad character and the previous contents of 
columns 15 and 16 are lost. Column 17 does not change. 



82 SHIFT Edit Command 



MTS 18: The MTS File Editor 
February 1988 



Purpose: 

Prototype: 

Action: 



Modifiers: 

Conditions: 

Example: 



SPREAD 
Edit Command Description 

To evenly renumber a region of the file. 

SPREAD [lpar] 

The lines in the region "lpar" are renumbered so that they are evenly spread 
with respect to the line-number range. This command is useful for obtaining 
more insertion room between lines when they are different by only .001. 

The last line is not renumbered (unless *L is specified), e.g., the command 
spread l 10 

renumbers lines from 1 up to but not including 10. 

None. 

SUCCESS if the region is successfully renumbered. 

SPREAD 1056 1057 

The above command evenly renumbers the lines in the file starting with 
line 1056 and ending with line preceding 1057. 
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STOP 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 
Conditions: 



To terminate the editing session and return to the caller. 

STOP 

The editing session is terminated and control is returned to the caller (normally 
MTS command mode). All editor workspace and buffers are released. 

An end-of-file also terminates the edit session. 

If the editor STOP option is ON, the STOP command becomes identical to the 
RETURN command, that is, the edit session is not terminated. 

If a patterned file name was specified on the EDIT command, the next file in the 
pattern sequence (if any) is edited. 

None. 

None. 
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TRANSLATE 
Edit Command Description 

To translate characters in one or more lines. 

(a) TRANSLATE [lpar] 'stringl'string2' 

(b) TRANSLATE [lpar] [[FROM] fromset] [TO] toset 

(c) TRANSLATE [lpar] 

(d) TRANSLATE [lpar] strexpl=strexp2 

With prototype (a), each character in "stringl" found in the line(s) is translated 
to the corresponding character in "string2". The correspondence is by 
character position in the strings. The line range translated is specified by 
"lpar". "stringl" must be the same length as "string2". 

With prototype (b), the characters in each line are taken from the character set 
"fromset" and the characters are translated to the corresponding characters in 
"toset". The legal "fromset-toset" pairs are: 



fromset toset 



EBCDIC 
ASCII 

uc 

LC 

BCD 

MTS 

IBM 



ASCII 

EBCDIC 

LC 

UC 

EBCDIC 

IBM 

MTS 



Function 

EBCDIC to ASCII conversion 

ASCII to EBCDIC conversion 

uppercase to lowercase conversion 

lowercase to uppercase conversion 

BCD to EBCDIC conversion 

MTS EBCDIC to IBM Code Page 37 EBCDIC 

conversion 

IBM Code Page 37 EBCDIC to MTS EBCDIC 

conversion 



The "fromset" character set may be omitted in every case except for BCD to 
EBCDIC conversion. 

The to/from sets MTS and IBM are for use in converting files created before 
February 22, 1988 on MTS or those saved on tape and restored. The MTS 
EBCDIC character set differs in only a few locations from that of the more 
widely used standard IBM Code Page 37 character set. The characters that 
will be changed by the command 

TRANSLATE lpar FROM MTS TO IBM 

are left and right square brackets, left and right curly braces, backslash, 
circumflex, grave, and tilde. Normally this command should only be applied 
once to a "source" file. 

With prototype (c), the last character translation specification given in the most 
recent TRANSLATE command specifying character translations is used. 
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Modifiers: 
Conditions: 

Examples: 



With prototype (d), the characters in the line range that are specified in 
"strexpl" are translated to the corresponding characters in "strexp2". The 
correspondence is by character position in the string specified in the string 
expressions. The length of the string from "strexpl" must be the same as in 
"strexp2". 

@CH, @COL, @LEN, @LNR, @MCL, @TR, @TX, @V, @VMV, @W, @X 

SUCCESS if at least one line is translated. EOF if a read beyond the end of the 
file is attempted. 

TRANSLATE 91 '1234'ABCD 1 

All the l's in line 91 are translated to A's, all 2's to B's, all 3's to C's, and 4's 
to D's. 

TRANSLATE /FILE FROM UC TO LC 

The entire file is translated from uppercase to lowercase alphabetics. 

TRANSLATE /FILE FROM MTS TO IBM 

The entire file is translated from MTS EBCDIC to IBM Code Page 37 
EBCDIC. 
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UNDO 
Edit Command Description 



Purpose: 

Prototype: 

Action: 



Modifiers: 
Conditions: 



To undo the action of the last command if the checkpoint feature is enabled. 

UNDO 

This command reverses the modifications made to the file for the last command 
issued which modified the file. For example, if lines are unintentionally 
destroyed by a previous command, they may be recovered provided no further 
commands have been issued which modified the file. To undo a particular 
range of lines, the RESTORE command should be used. The UNDO command 
may undo the action of a previous UNDO command. The @NV modifier is 
recommended for suppressing verification when a large number of lines are 
involved. 

For this command to be operative, the checkpointing must be either ON or OFF 
(the default), but not NEVER. 

See the section "Checkpoint/Restore Facility" for further details. 

@CH, @LEN, @LNR, @TR, @TX, @V, @W 

None. 
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UNLOCK 
Edit Command Description 

Purpose: To close and unlock the edit file. This allows other users to lock the file. 

Prototype: UNLOCK 

UNLK 

Action: If the edit file is a disk file, all current buffers in virtual memory are written to 

the disk. The file is then unlocked. The action is the same as that of the MTS 
UNLK subroutine (see MTS Volume 3, System Subroutine Descriptions). 

UNLOCK has no effect on checkpoint information; this information remains 
available to the RESTORE and UNDO commands. 
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VISUAL 
Edit Command Description 



Purpose: 



Prototype: 
Action: 



Modifiers: 



Conditions: 



To enter visual mode. The file is displayed on the video screen of a display 
terminal. As changes are made to the screen, they are recorded in the file. 
This allows the user to edit the file using the local terminal features of the 
display terminal. 

VISUAL [linenumber] 

When the VISUAL command is issued, the contents of the file are displayed on 
the video screen starting at line "linenumber". If the line number is omitted, 
the current line is the first line displayed. In general, the current line is the 
last line edited or displayed by the file editor. Initially, the current line is the 
first line of the file. 

See the section "Visual Mode" for further details on using visual mode in the 
editor. 

@HEX 

If @HEX is specified, the screen display will contain the hexadecimal 
representation of the data. The display remains in hexadecimal until another 
VISUAL(@NHEX) command is given. 

None. 
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WINDOW 
Edit Command Description 



Purpose: 
Prototype: 



Action: 



To set the column range for verification printing and the width of the data to be 
viewed in visual mode. 

(a) WIN DOW 

(b) WINDOW left 

(c) WINDOW left right 

(d) WIN DOW {LEFT I RIGHT} 

(e) WINDOW {LEFT I RIGHT} count 

With prototype (a), the window pointers (the left and right column values) are 
set to 1 and 32767 (the defaults). 

With prototype (b), the window pointers are set to "left" and 32767. 

With prototype (c), the window pointers are set to "left" and "right". 

With prototype (d), the window pointers are shifted to the left or right extreme 
so that either the leftmost or rightmost full-screen width is displayed. When 
the window is shifted to the left, the left column value is set to 1 and the right 
column value is set to the width of the screen. When the window is shifted to 
the right, the right column value is set to the last character of the longest line in 
the file and the left column is set to the right column value less the screen width. 

With prototype (e), the window pointers are decremented (with LEFT) or 
incremented (with RIGHT) by the value of "count". This in effect shifts the 
window of the screen to the left or right by the value of "count". 

The window pointers set by the WINDOW command remain in effect for both 
line mode and visual mode. That is, if a WINDOW LEFT command is executed 
in visual mode for a terminal that supports a window size of 68 characters, then 
only columns 1-68 would be printed when a subsequent PRINT command is 
executed in line mode. 

Prototypes (a), (b), and (c) cause lines that are longer than the screen width to be 
wrapped in visual mode. Prototypes (d) and (e) truncate lines outside of the 
window area instead of wrapping them. 

If a line being verified is less than "left" characters in length, then nothing is 
printed for that line. 

In visual mode, lines that have their rightmost portions truncated because of a 
window setting are marked with ">" in the line-number field. Lines that 
cannot be seen because a window setting truncates them on the left are marked 
with "<". In both cases, the markers point towards the hidden part of the lines. 
In addition, truncated lines will be padded with the current pad character 
(initially a blank) if data is added on the screen to the line. This is convenient 
for adding comments to a program, for example. 
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Modifiers: None. 

Conditions: SUCCESS if no error messages are generated. 

Example: window 2 4 



In the above example, the window pointers are set to columns 2 and 4, 
respectively. This could be useful for printing only columns 2 through 4 of 
a file containing an object module. If visual mode is entered, only columns 
2,3, and 4 will be displayed for each line on the screen. 
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Purpose: 

Prototype: 

Action: 

Modifiers: 

Conditions: 

Example: 



/name 
Edit Command Description 

To print the line numbers defined by the region "/name". 

/name 

This command prints the line numbers that are the bounds for the region 
"/name". 

None. 

None. 

/ABC 

The above command prints the line numbers that are the bounds for the 
region /ABC. 
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!name 



Edit Command Description 



Purpose: 
Prototype: 

Action: 



Modifiers: 

Conditions: 

Example: 



To execute an edit procedure. 

(a) !name n 

(b) !name 

With prototype (a), the edit procedure "!name" is executed "n" times. 

With prototype (b), the edit procedure is executed once. 

The action of this command is identical to that of the EXECUTE command. 

None. 

None. 

!PROCB 10 

In the above example, the edit procedure IPROCB is executed 10 times. 
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Purpose: 
Prototype: 



Action: 



Modifiers: 
Conditions: 

Example: 



±n 



Edit Command Description 



To move the current-line pointer or visual-mode top line forward or backward 
"n" lines. 

(a) n 

(b) +n 

(c) -n 

where "n" is an integer. 

This command moves the current-line pointer (*) or visual-mode top line (*VT) 
forward or backward by "n" lines. The sign of the number indicates the 
direction to move. 

Thus, if the current line is 4, the command 

1 

moves the current-line pointer or visual-mode top line to the next line (which is 
not necessarily 5). Likewise, 

-1 

moves the current-line pointer or visual-mode top line to the preceding line 
(which is not necessarily 3). 

In an edit procedure, ±n only affects the current-line pointer. 

@LEN, @LNR, @TX, @V, @W, @X 

SUCCESS if the current-line pointer is moved. EOF if the current-line pointer 
is moved beyond the end of the file. 



10 



The above command moves the visual-mode top line forward by 10 lines, if 
in visual mode, or the current-line pointer by 10 lines, otherwise. 
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±n.n 
Edit Command Description 

To increment the current-line pointer or visual-mode top line by "±n.n". 

±n.n 

where "n.n" is a decimal number. 

This command increments the current-line pointer (*) or visual-mode top line 
(*VT) by "±n.n". The number "n.n" must contain a decimal point and must be in 
the range -99999.999 to 99999.999. 

In an edit procedure, ±n only affects the current-line pointer. 

@LEN, @LNR, @TX, @V, @W, @X 

EOF if the current-line pointer or visual-mode top line is set to a line which does 
not exist in the file. 



10.0 



The above example increments the visual-mode top line by 10.0, if in visual 
mode, or the current-line pointer by 10.0, otherwise. 
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VISUAL MODE 



For the display-screen terminal user, the visual-mode feature provides a very powerful method for 
entering data into a newly created file or for editing an existing file. Visual mode is supported on 
several types of terminals including the Ontel, the DEC VT100, the IBM 3278, the Ontel Amigo, IBM 
PC and its compatibles, and the Apple Macintosh microcomputers. 
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Figure 1. Visual-Mode Screen Format 
In visual mode, the screen is divided into three areas: 

(1) A "file area" consisting of several lines of the file with their associated file line numbers. 

(2) A "work area" consisting of two fields: a 10-character "cost field" and a "work field," which 
may be extended for as long as needed. 

(3) A "ruler area" that is the last line of the screen which is marked by default as a ruler for 
quick counting of column numbers and lengths in the file and work areas. This area may 
also be set to a status line as described in the section "Setting the Visual-Mode Ruler." 

Visual mode is entered by first entering edit mode in the editor, i.e., 

EDIT filename 

and then issuing the VISUAL command in the form 

VISUAL n 

where "n" is the line number of the first line in the file that is to appear at the top of the screen. If "n" is 
omitted, the current line (initially the first line of the file) appears at the top of the screen. 
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After entering visual mode, the user may make changes directly to the text of the file as it is 
displayed on the screen. These changes are recorded in a screen buffer within the terminal and are 
used by the editor at appropriate times to update the actual contents of the file. 

Overview of Visual Mode with the Ontel 

The following paragraphs briefly describe the use of visual mode with the Ontel terminal, one of the 
simplest terminals that can be used with visual mode. The complete descriptions of the use of visual 
mode with the Ontel and with other terminals follow at the end of this section. 

The movement of the cursor on the Ontel is controlled by the CURSOR-RIGHT, CURSOR-LEFT, 
CURSOR-UP, and CURSOR-DOWN keys. These keys are labelled with arrows. Movement of the 
cursor is also controlled by the TAB and RETURN keys. The following keys have special function in 
visual mode: 

(1) The INSERT MODE key may be used to insert characters into a line. This is done by 
moving the cursor to the position of the insert, pressing the INSERT MODE key to enter 
insert mode, and then entering the desired text. To exit insert mode after the insertion 
is completed, the INSERT MODE key may be pressed again. 

(2) The DELETE key may be used to delete characters from a line. This is done by moving 
the cursor to the position of the deletion and pressing the DELETE key as many times as 
needed to delete the undesired characters. 

(3) The ERASE TO EOL key may be used to delete all characters in a line to the right of the 
cursor. An entire line may be deleted by moving the cursor to the beginning of the line 
before pressing ERASE TO EOL. 

The method of extending lines and inserting new lines into the file is given below in the discussion of 
the program-function keys. 

As changes are made to the screen, they are stored within a buffer inside the terminal (at this point, 
they have not been transmitted to MTS and therefore, the file has not been updated by the editor). 
When the user either exits visual mode or causes the editor to rewrite the screen, the changes to the file 
are transmitted to MTS and the editor, and the file is updated at that time. The following operations 
cause the file to be updated by the editor: 

(1) Pressing either the ATTN or EOF key which exits visual mode and returns to normal 
editing mode. 

(2) Pressing the PFO key which updates the file without exiting visual mode. 

(3) Pressing any of the other program-function (PF) keys which executes an editor visual 
program function. 

Pressing the FIX key deletes the current changes to the screen buffer and rewrites the screen to its 
previous status when the file was last updated. 

Thirteen different editor visual program functions (VPFs) are predefined for the Ontel terminal. 
These program functions may be used to execute special editor visual mode commands. On the Ontel, 
these visual program functions may be accessed by pressing the numeric keys in conjunction with the 
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CTRL key or by pressing one of the program-function keys along the top row of the terminal. 
VPF OntelKey Effect 






PFO 


Update screen 


1 


CTRL-lorPFl 


Back up 10 lines 


2 


CTRL-2orPF2 


Append to work area 


3 


CTRL-3orPF3 


Memory 1 


4 


CTRL-4orPF4 


Advance 10 lines 


5 


CTRL-5orPF5 


Insert work area 


6 


CTRL-6orPF6 


Memory 2 


7 


CTRL-7orPF7 


Advance 1 line 


8 


CTRL-8orPF8 


Execute work area 


9 


CTRL-9 


Memory 3 


10 


CTRL-0 


Insert lines 


11 


CTRL- 


Extend line 


12 


CTRL- 1 


Previous memory 



Editor visual program functions 1, 4, and 7 are used to move new sections of the file onto the screen: 

(1) VPF 1 moves 10 lines backward in the file. This is equivalent to the file editor command 
-10 or the device command %WB=10. 

(2) VPF 4 moves 10 lines forward in the file. This is equivalent to the file editor command 
+10 or the device command %WF=10. 

(3) VPF 7 moves 1 line forward in the file. This is equivalent to the file editor command +1 
or the device command %WF=1. 

Editor visual program functions 10 and 11 are used to insert a new line into the file or to extend a 
line beyond the right boundary of the file area: 

(1) VPF 10 inserts a nonnumbered, null-length line (space to insert a new line) immediately 
after the cursor position. This line will be marked by a period in the line-number field. 
Information then may be inserted into this line space and it will be written as a new line 
when the file is updated. Consecutive pressing of VPF 10 doubles the number of lines 
available for insertion and decreases the line-number spacing. Note: If the line-number 
number spacing is .001, VPF 10 will not work and the file must then be renumbered. 

(2) If, in the process of inserting characters into a line, the right margin of the screen is 
reached, VPF 11 will create another screen line of space so that the line may be continued 
into this region. Note: Occasionally, VPF 11 must be used before the right margin is 
reached; this is because the line has blanks appended to the end of it. 

The work area is composed of a "cost field" and a "work field." The work field may be used as a 
depository to either edit lines from the file or to compose edit commands to be subsequently applied to 
the file. 

The work field is used by editor visual program functions 2, 5, and 8: 

(1) VPF 2 appends to the work field the last part of the line in the file area pointed to by the 
cursor. 
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(2) VPF 5 inserts the contents of the work field into the line pointed to by the cursor at the 
position of the cursor. The user may make a copy of a line or a part of a line in the work 
field (VPF 2), modify it, and deposit the resulting line elsewhere in the file (VPF 5). 

(3) VPF 8 takes the contents of the work field and applies it as an edit command to the file. 
For example, the user may enter the following command into the work field 

SHIFT /FILE LEFT 5 

and execute the VPF 8 command. This shifts the contents of the entire file to the left by 5 
columns. 

The cost field, just before the work field, normally contains the total cost of the terminal session. If 
this field is modified to a line number, the screen will be positioned to that line number after any visual 
program function is executed. Editor visual program functions 1, 4, and 7 (normally for 
file-positioning) are ignored in this case. If the first character of the cost field is set to "C", the contents 
of the "work field" is executed as an editor command; the line that the cursor is pointing to becomes the 
editor "current line" for the editor command in the work area (this is the same function as performed by 
VPF 8). The displaying of the cost of the edit session in the cost field of the work area may be 
suppressed by issuing the the command 

SETVMCOST=OFF 

This may be useful when using the cost field to reposition the file to lines with large line numbers. A 
colon identifies the cost work field when VMCOST is OFF. 

Editor visual program functions 3, 6, 9, and 12 control the file-position memory feature of visual 
mode. These may be set to "remember" a particular position in the file so that the user can quickly 
return to it at a later time. 

(1) VPF 3, VPF 6, and VPF 9 control memory positions 1, 2, and 3, respectively, which are 
used to define the "remembered" positions and return to them. To define the current file 
position on the screen as a remembered position, press the memory position key twice in 
succession. To return to the remembered position, press the key once. Memory position 
1 is initially defined as the first line of the file, memory position 2 is defined as line 1000, 
and memory position 3 is defined as the last line of the file. 

(2) VPF 12 moves the screen to the "previous" file position which is either 

(a) the file position before either the last memory key or VPF 12 was pressed, 

(b) the file position before a line number in the cost field was set, 

(c) the file position when visual mode was last exited, or 

(d) the file position before an edit command was executed via VPF 8 or the character 
"C" in the cost field. 

Visual mode may be exited by pressing the ATTN key or the EOF key (see the descriptions of the 
individual terminals that follow for the correct definition of these keys). If the EOF key is used, the 
contents of the "work area" are written to *SINK* for further use. Both exit methods will update the 
editor current line to the line last pointed to by the cursor if MCL is in effect. If an error occurs (I/O 
error, for example), then the editor may also leave visual mode to print the error message. 
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The action of the entire VISUAL command may be undone by pressing the ATTN key and issuing 
the UNDO command. Note that if an edit command is executed during visual mode, the modifications 
done before that command may not be undone. An UNDO command will restore all modifications only 
after and including that command. If the user wants complete restoring ability, the CHECKPOINT 
command must be issued followed by the RESTORE command to undo the changes made. 

On the Ontel terminal, a reverse-video line number is a warning that the user may not modify that 
line on the screen (other terminals may denote this by using an intensified line number). This occurs 
because either 

(1) the line contains nonprinting characters which have been displayed with question marks 
inserted in their place, or 

(2) the line contains lowercase letters and the LC option is set to OFF. 

An update to such a line would either replace the nonprinting characters with question marks or 
replace the lowercase characters with uppercase characters. Visual mode normally should not be 
used for editing lines which contain characters that are not in the terminal keyboard character set. 
The user may override this restriction by specifying the editor NPP (NONPRINTPROTECT) option, 
e.g., 

SETNPP=OFF 

Verification of edit commands executed from the work area is normally suppressed. Verification 
may be enabled by appending the @VMV (VISUALMODEVERIFY) modifier to the executed command 
or by specifying the VMV option, e.g., 

SETVMV=ON 

In this case, verification will be written into the terminal conversation buffer and will be visible when 
visual mode is exited. 

The user will be automatically signed off by the system in visual mode if the screen is not updated 
within a 30-minute interval. 

If @HEX is specified, the screen display will contain the hexadecimal representation of the data. 
The display remains in hexadecimal until another VISUAL@NHEX command is given. 

In the following Ontel example, Panels 1 and 2 illustrate the initial entering of text into an empty 
file. The initial command sequence is 

EDIT filename 
V 

After entering visual mode, the cursor (shown by the underscore character) is pointing to the beginning 
of line 1 and the screen is filled with empty lines. The $. 12 figure in the lower-left corner is the current 
cost of the terminal session. 

After the text has been entered and the file is updated by executing VPF (pressing the PFO key), 
the screen will appear as shown in Panel 2. The current cost of the terminal session has now risen to 
$.24. 
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Panel 3 shows the file after some simple editing is done to lines 7, 8, and 9. In line 7, the word 
"goop" is changed to "good" by moving the cursor to the position of the "p" and typing "d". In line 8, the 
phrase " Zones," is inserted by moving the cursor to the position ",", pressing the INSERT MODE key, 
and typing the text to be inserted. In line 9, the double occurrence of "the " is corrected by moving the 
cursor to the "t" of the second "the" and pressing the DELETE key four times. 

Panels 4 through 7 illustrate the addition of new text to the file. In this case, the new text is to be 
inserted at line 16. The screen as shown in Panel 4 is obtained by giving the command 

v 14 

followed by moving the cursor to line 16 and executing VPF 10 (the CTRL-0 key) five times. As text is 
inserted after line 16, it will go on lines 16.05, 16.1, 16.15, etc. 

Panel 5 illustrates the effect when a data or text line is to be inserted that is longer than one screen 
line. In this case, when the user nears the end of typing on line 16.4, VPF 11 (the CTRL — key) should 
be executed to extend the line by one screen line. When VPF 11 is executed, the file is automatically 
updated and line numbers are assigned to the new lines. After the completion of the line, the screen 
will appear as shown in Panel 5. Because of the effect of VPF 11, line 19 has now disappeared from the 
screen. 

Panel 6 illustrates the appearance of the screen after the remainder of the text has been entered and 
before VPF (the PFO key) is executed; Panel 7 illustrates the screen after VPF is executed. Note 
that line 16.82 contains at least one blank while line 16.88 was empty. At this point, the current cost 
of the session is $.45. 

Panels 8 and 9 illustrate the use of the work field to execute an edit command on the file. In Panel 
8, the cursor has been positioned to the beginning of the work field and then the text of the SHIFT 
command has been entered in the work field. Next, VPF 8 (the CTRL-8 key) has been invoked to 
execute the SHIFT command, which shifts the contents of the entire file to the left by 5 spaces; the 
result of this shift is shown in Panel 9. 



102 Visual Mode 



MTS 18: The MTS File Editor 
February 1988 




Figure 1 . Screen Ready for Initial Text Entering 



He had bought a large map representing the sea. 
Without the least vestige of land; 

And the crew were much pleased when they found It to be 
A map they could all understand. 

"What's the goop of Mercator's North Poles and Equators, 
Tropics, and Meridian Lines?" 

So the Bellman would cry: and the the crew would reply, 
They are merely conventional signs! 

"Other maps are such shapes, with their Islands and capes! 
But we've got our brave Captain to thank" 

(So the crew would protest) "that he's bought us the best • 
A perfect and absolute blank!" 

From "The Bellman's Speech" In 
The Hunting of the Snark by 
Lewis Carrol 1 



$.24 
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Figure 2. Screen After Initial Text Entering 
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He had bought a large map representing the sea. 
Without the least vestige of land; 

And the crew were much pleased when they found It to be 
A map they could all understand. 

"What's the good of Mercator's North Poles and Equators, 
Tropics, Zones, and Meridian Lines?" 

So the Bellman would cry: and_the crew would reply. 
They are merely conventional signs! 

"Other maps are such shapes, with their islands and capes! 
But we've got our brave Captain to thank" 

(So the crew would protest) "that he's bought us the best 
A perfect and absolute blank!" 

From "The Bellman's Speech" in 
The Hunting of the Snark by 
Lewis Carrol 1 
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Figure 3. Screen After Text Correction 
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16 



(So the crew would protest) "that he's bought us the best 
A perfect and absolute blank!" 



17 From "The Bellman's Speech" In 

18 The Hunting of the Snark by 

19 Lewis Carrol 1 
$.29 
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Figure 4. Screen Ready for Additional Text Insertion 
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14 (So the crew would protest) "that he's bought us the best - 

15 A perfect and absolute blank!" 
16 

16.05 This was charming, no doubt: but they shortly found out 

16.1 That the Captain they trusted so well 
16.15 Had only one notion for crossing the ocean, 

16.2 And that was to tingle his bell. 
16.25 

16.3 He was thoughtful and grave - but the orders he gave 
16.35 Were enough to bewilder a crew. 

16.4 When he cried, "Steer to starboard, but keep her head larboar 



d! 



17 From "The Bellman's Speech" in 

18 The Hunting of the Snark by 
$.37 
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Figure 5 . Screen After Extended Line Is Entered 



14 


(So the crew would protest) "that he's bought us the best - 


15 
16 
16.05 


A perfect and absolute blank!" 


This was charming, no doubt: but they shortly found out 


16. 1 


That the Captain they trusted so well 


16. 15 


Had only one notion for crossing the ocean. 


16.2 


And that was to tingle his bell. 


16.25 




16.3 


He was thoughtful and grave - but the orders he gave 


16.35 


Were enough to bewilder a crew. 


16.4 
d! " 


When he cried. "Steer to starboard, but keep her head larboar 


What on earth was the helmsman to do? 




Then the bowsprit got mixed with the rudder sometimes: 




A thing, as the Bellman remarked. 




That frequently happens in tropical climes. 




When a vessel is. so to speak, "snarked." 


17 


From "The Bellman's Speech" in 


18 


The Hunting of the Snark by 


$.43 
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Figure 6. Screen After Additional Text Insertion 
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14 


(So the crew would protest) "that he's bought us the best - 


15 
16 
16.05 


A perfect and absolute 


blank ! " 


This was charming, no doubt: but they shortly found out 


16. 1 


That the Captain they t 


rusted so wel 1 


16. 15 


Had only one notion for 


crossing the ocean. 


16.2 


And that was to tingle 


his bel 1 


16.25 






16.3 


He was thoughtful and g 


rave - but the orders he gave 


16.35 


Were enough to bewilder 


a crew. 


16.4 
16.46 


When he cried, "Steer to starboard, but keep her head larboar 


What on earth was the h 


elmsman to do? 


16.52 






16.58 


Then the bowsprit got mixed with the rudder sometimes: 


16.64 


A thing, as the Bellman 


remarked. 


16.7 


That frequently happens 


in tropical cl imes , 


16.76 


When a vessel is, so to 


speak, "snarked." 


16.82 






17 




From "The Bellman's Speech" in 


18 




The Hunting of the Snark by 


19 




Lewi s Carrol 1 


$.45 
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Figure 7. Screen After File Is Updated 
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(So the crew would protest) "that he's bought us the best - 
A perfect and absolute blank!" 

This was charming, no doubt: but they shortly found out 

That the Captain they trusted so well 

Had only one notion for crossing the ocean. 

And that was to tingle his bell. 

He was thoughtful and grave - but the orders he gave 

Were enough to bewilder a crew. 

When he cried, "Steer to starboard, but keep her head larboar 

What on earth was the helmsman to do? 

Then the bowsprit got mixed with the rudder sometimes: 

A thing, as the Bellman remarked, 

That frequently happens in tropical climes. 

When a vessel is, so to speak, "snarked." 

From "The Bellman's Speech" in 
The Hunting of the Snark by 
Lewis Carrol 1 

shift /file left 5_ 

123456789 123456789 123456789 123456789 123456789 123456789 12345678 



Figure 8. Screen Before SHIFT Command Execution 
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14 (So the crew would protest) "that he's bought us the best - 

15 A perfect and absolute blank!" 
16 

16.05 This was charming, no doubt: but they shortly found out 

16.1 That the Captain they trusted so well 
16.15 Had only one notion for crossing the ocean, 

16.2 And that was to tingle his bell. 
16.25 

16.3 He was thoughtful and grave - but the orders he gave 
16.35 Were enough to bewilder a crew. 

16.4 When he cried, "Steer to starboard, but keep her head larboard!" 
16.46 What on earth was the helmsman to do? 

16.52 

16.58 Then the bowsprit got mixed with the rudder sometimes: 

16.64 A thing, as the Bellman remarked, 

16.7 That frequently happens In tropical climes, 

16.76 When a vessel is, so to speak, "snarked. " 

16.82 

17 From "The Bellman's Speech" in 

18 The Hunting of the Snark by 

19 Lewi s Carrol 1 

$.47 shift /f 1 le left 5_ 
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Figure 9. Final Screen Contents After Shifting 
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USING VISUAL MODE WITH THE ONTEL TERMINAL 

The keyboard layout for the Ontel terminal is as follows: 



PAUSE 




CAPS 
LOCK 


INSERT 
MODE 



%WB>20 %WF=20 



%WB 



%WF 



%WL=60 



%WR=60 



%BLANK 







; ■•#$%* 
12 3 4 5 6 


( ) : 

7 8 9 - t \ 


1- 


ATTN 


EOF 


FIX 


TAB QWERTY 


U 1 P ' ' 

[ 3 




OEL 


HOME 


DEL£T£ 


ERASE 

TO 

eoi. 


SHIFT 
LOCK 


A S F G H 


+ * 
J K L RETURN 
» 


\ 

<3> 


t 


\ 


BACK 
TAB 




SHIFT Z X C V B 


< > ? 
N M SHIFT 

» • / 


CTRL 


— 


— 


ZIP 






SPACE BAR 






CONTROL 


PAD 



PROG 



7 


8 


9 


- 


4 


5 


6 


1 


2 


3 


+ 


<D 





The Ontel Keyboard - Model 1503 

The movement of the cursor is controlled by the CURSOR-RIGHT, CURSOR-LEFT, CURSOR-UP, 
and CURSOR-DOWN keys. These keys are labelled with arrows. Movement of the cursor is also 
controlled by the TAB, BACKTAB, ZIP, HOME, and RETURN keys. 

The following keys on the Ontel have special functions in visual mode. The actions of these keys 
are controlled only by the terminal routines and not by the editor program itself. 



Ontel Key 

INSERT MODE 

DELETE 

SHIFT-DELETE 

ERASE TO EOL 

FIX 

SHIFT-HOME 



Effect 

Enter or exit insertion mode (toggle switch) 

Delete the character at the cursor 

Delete the work at the cursor 

Delete all characters to the right of the cursor 

Discard all current screen changes 

Move cursor to work field 



Across the top of the keyboard is the program-function pad. The nine rightmost keys are called 
program-function (PF) keys and are labelled with Ontel device commands. They are arranged in the 
following format: 



%WB=20 


%WF=20 


%WB 


%WF 




%WL 


%WL=60 


%WR=60 


%BLANK 




PROG 



PF1 



PF2 



PF3 



PF4 



PF5 



PF6 



PF7 



PF8 



On the Ontel Model OP-l/R (the gray models), the PROG key is labelled as %ENTER. 
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Each program-function key has an Ontel program function associated with it. These Ontel 
program functions are named PFAO through PFA8 (for the unshifted keys) and PFBO through PFB8 
(for the shifted keys). 



PFAO 


PFA1 


PFA2 


PFA3 




PFBO 


PFB1 


PFB2 


PFB3 



PFA4 


PFA5 


PFA6 


PFA7 


Unshifted 


PFB4 


PFB5 


PFB6 


PFB7 



PFA8 



PFB8 



Shifted 

In addition, the top row of numeric keys, when depressed in combination with the CTRL key, have 
Ontel program functions assigned to them: 



1 


2 


3 


4 


5 


6 


7 


8 


9 





- 


t 



PFA1 PFA2 PFA3 PFA4 PFA5 PFA6 PFA7 PFA8 PFA9 PFA10 PFA11 PFA12 

Normally (when not in visual mode), the program-function keys execute the Ontel device commands 
that are inscribed on the key tops, both in the unshifted and shifted positions. In visual mode, each of 
the program-function keys is assigned to an editor visual program function (VPF) for visual-mode 
editing. These visual program functions in turn are assigned to visual-mode commands. The default 
key assignments for the Ontel terminal are as follows: 



VPF 


Ontel Key 


Ontel PF 


Default Assignment 


-2 


EOF 


_ 


VEXITED WORK 


-1 


ATTN 


- 


VEXIT 





PFO 


PFAO 


VUPDATE 


1 


CTRL-lorPFl 


PFA1 


LINE *VT COUNT=-10 


2 


CTRL-2orPF2 


PFA2 


VPFB 


3 


CTRL-3orPF3 


PFA3 


VMEMORY 1 


4 


CTRL-4orPF4 


PFA4 


LINE*VTCOUNT=10 


5 


CTRL-5orPF5 


PFA5 


VPFE 


6 


CTRL-6orPF6 


PFA6 


VMEMORY 2 


7 


CTRL-7orPF7 


PFA7 


LINE*VTCOUNT=l 


8 


CTRL-8orPF8 


PFA8 


VEXECUTE 


9 


CTRL-9 


PFA9 


VMEMORY 3 


10 


CTRL-0 


PFA10 


VINSERT 1 2 


11 


CTRL- 


PFA11 


VEXTEND 


12 


CTRL- 1 


PFA12 


VPREVIOUS 


13 


- 


PFA13 


LINE *VT COUNT=-10 


14 


- 


PFA14 


VPFB 


15 


- 


PFA15 


VMEMORY 1 


16 


SHIFT-PFO 


PFBO 


LINE*VTCOUNT=10 


17 


SHIFT-PF1 


PFB1 


VPFE 


18 


SHIFT-PF2 


PFB2 


VMEMORY 2 


19 


SHIFT-PF3 


PFB3 


LINE*VTCOUNT=l 


20 


SHIFT-PF4 


PFB4 


VEXECUTE 



Visual Mode 109 



MTS 18: 


The MTS File Editor 






February 


1988 








21 




SHIFT-PF5 


PFB5 


VMEMORY3 


22 




SHIFT-PF6 


PFB6 


VINSERT 1 2 


23 




SHIFT-PF7 


PFB7 


VEXTEND 


24 




SHIFT-PF8 


PFB8 


VPREVIOUS 


25 




- 


PFB9 


Undefined 


26 




- 


PFB10 


Undefined 


27 




- 


PFB11 


Undefined 


28 




- 


PFB12 


Undefined 


29 




- 


PFB13 


Undefined 


30 




- 


PFB14 


Undefined 


31 




- 


PFB15 


Undefined 



Note that the default assignments for editor visual program functions (VPFs) 1 through 12 are the 
same as for 13 through 24. Editor VPFs 13 through 24 do not have a default key assignment for the 
Ontel, but the user may assign the Ontel PF with an Ontel key (see the section "Redefining the Ontel 
Keyboard" below). Editor VPFs 25 through 31 are initially undefined, but they may be denned by the 
user (see the section "Reassigning Ontel Visual Program Functions" below). 

Using the Numeric Pad 

The numeric pad may be redefined to serve as a program-function pad by issuing the Ontel device 
command 

%PAD=PFKEYS 

The numeric pad keys then have the following configuration: 



Unshifted 



PFA13 


PFA14 


PFA15 


PFAO 




PFA1 


PFA2 


PFA3 


PFAO 


PFBO 


PFB1 


PFB2 


PFA4 


PFA5 


PFA6 


PFB3 


PFB4 


PFB5 


PFB8 


PFA7 


PFA8 


PFA9 


PFA12 


PFB6 


PFB7 


PFA10 


PFA11 



Shifted 



This redefinition is effective both in visual mode and in normal terminal mode. The configuration of 
the numeric pad depends on whether the user is in visual mode or normal line mode. 

The %PAD device command may be issued directly from the terminal keyboard or may be issued 
from the user's sigfile using the command 

$CONTROL *MSOURCE* PAD=PFKEYS 

When the user is not in visual mode, the numeric-pad keys either will be defaulted to Ontel device 
commands or will have definitions that are assigned by the user by the %FUNCTION device command 
(see MTS Volume 4, Terminals and Networks in MTS). 
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If the %PAD=PFKEYS device command is not given, the keys of the numeric pad retain their 
normal numeric-mode functions while in visual mode. 

The function of the numeric pad may be restored to numeric mode by issuing the device command 

%PAD=NUMERIC 

Reassigning Ontel Visual Program Functions 

The example below illustrates how the editor visual program functions may be reassigned to take 
advantage of the additional Ontel program functions that are available on the numeric pad. 

VPF 13=LINE *VT COUNT=l (assign PFA13) 

VPF 14=LINE *VT COUNT=10 (assign PFA14) 

VPF 15=LINE *VT COUNT=100 (assign PFA15) 

VPF 16=LINE *VT COUNT=-l (assign PFBO) 

VPF 17=LINE *VT COUNT=-10 (assign PFB1) 

VPF 18=LINE *VT COUNT=-100 (assign PFB2) 

VPF 19=VMEMORY 1 (assign PFB3) 

VPF 20=VMEMORY 2 (assign PFB4) 

VPF 21=VMEMORY 3 (assign PFB5) 

VPF 22=LINE *F (assign PFB6) 

VPF 23=LINE *L (assign PFB7) 

VPF 24=VPREVIOUS (assign PFB8) 

Editor visual program functions VPF 13 through VPF 24 are reassigned to different visual mode 
commands so that they do not duplicate VPF 1 through VPF 12. This in effect makes the Ontel 
unshifted numeric pad which uses the Ontel program functions PFA13 through PFA15 and PFBO 
through PFB8 different from the shifted numeric pad which uses Ontel program functions PFAO 
through PFA12. In this example, a selection of visual mode and normal edit commands is chosen so 
that the user may easily move around within the file. 

As a second example, the following editor initialization file will reassign part of the program 
functions to visual-mode commands, part to normal editor commands, and part to edit procedures to 
provide more advanced capabilities for the program-function pad. 

* 

* Define a procedure to execute a %GRAB device 

* command to initiate a second session 
* 

PROCEDURE ! GRAB 

UNLOCK 

$ CONTROL *MSOURCE* GRAB 

END 

* 

* Define a procedure to execute a %FLIP device 

* command to switch to the alternate session 
* 

PROCEDURE !FLIP 

UNLOCK 

$ CONTROL *MSOURCE* FLIP 

END 

* 

* Define a procedure to set variable A 

* to beginning line for MOVE after 

* moving the cursor to desired line 
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PROCEDURE ! SETA 

LET A=* 

END 



Set variable B to ending line for MOVE 
after moving the cursor to desired line 



PROCEDURE ! SETB 






LET B=* 






END 

* 






* Redefine some PF keys 

* 






VPF 13=! GRAB 


(assign 


PFA13) 


VPF 14=! FLIP 


(assign 


PFA14) 


VPF 15=! SETA 


(assign 


PFA15) 


VPF 16=! SETB 


(assign 


PFBO) 


VPF 17=M0VE A B TO * 


(assign 


PFB1) 


VPF 18=COMBINE * *N LEN=65 


(assign 


PFB2) 


VPF 19=VSPLIT 


(assign 


PFB3) 


VPF 20=COPY * TO * 


(assign 


PFB4) 


VPF 21=RENUMBER 


(assign 


PFA5) 



The above example illustrates how edit procedures may be used to execute terminal device commands 
and more complex editor commands. PFA13 and PFA14 have been reassigned to execute the %GRAB 
and %FLIP terminal device commands. These commands are executed via the MTS $CONTROL 
command (see MTS Volumes 1 and 4 for further details about issuing terminal device commands via 
the $CONTROL command). The edit UNLOCK command writes the current changes on the screen 
into the edit file and unlocks the file before the device command is executed. PFA15, PFBO, and PFB1 
have been reassigned to work in concert to easily move lines in the file from one location to another. 
PFA15 and PFBO specify the beginning and ending bounds of the lines to be moved and PFB1 moves 
the text to the location specified by the current position of the cursor. PFB2 has been reassigned to the 
COMBINE command to combine the line pointed to by the cursor with the next line; the resultant lines 
are limited to 65 characters. PFB3 has been reassigned to the VSPLIT command which splits a line 
into two lines at the position of the cursor. PFB4 is reassigned to the COPY command to duplicate the 
line pointed to by the cursor. PFB5 is reassigned to the RENUMBER command. 

Redefining the Ontel Keyboard 

The Ontel terminal supports a total of 32 Ontel program functions, named PFAO through PFA15 
and PFBO through PFB15. By default, program-function keys PFO through PF8 are defined on the 
function pad across the top row of the keyboard as Ontel program functions PFAO through PFA8, and 
the CTRL-1 through CTRL- 1 keys are defined as Ontel program functions PFA1 through PFA12. All 
other Ontel program functions must be assigned to specific terminal keys by the user. 

The %FUNCTION device command may be used to assign the remaining Ontel program functions 
PFB9 through PFB15 or to reassign Ontel program functions PFAO through PFA15 and PFBO through 
PFB8. The %FUNCTION device command is given in the form 

%FUNCTIONnm 

where "n" is a hexadecimal value describing the key to be reassigned and "m" is a hexadecimal value 
describing the function to be assigned to the key. 
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The hexadecimal values for program-function keys PFO through PF8 on the function pad are as 
follows: 



Hex Value 


Hex Value 


Unshifted 


Shifted 


E4 


F4 


E5 


F5 


E6 


F6 


E7 


F7 


CE 


DE 


CA 


DA 


CC 


DC 


EE 


FE 


EF 


FF 



Hex Value 


Hex Value 


Unshifted 


Shifted 


CO 


DO 


CI 


Dl 


C2 


D2 


C3 


D3 


C4 


D4 


C5 


D5 


C6 


D6 


C7 


D7 


C8 


D8 


C9 


D9 


CD 


DD 


CF 


DF 


CB 


DB 



The hexadecimal values for the keys on the numeric pad are as follows: 



Key 


1 
2 
3 
4 
5 
6 
7 
8 
9 
+ 



The hexadecimal values for the remainder of the keys on the Ontel keyboard are given in MTS Volume 
4, Terminals and Networks in MTS. 

The hexadecimal values for the Ontel program functions are as follows: 

Program Function Hex Value Editor VPF 

PFAO through PFA15 80 through 8F through 15 

PFBO through PFB15 90 through 9F 16 through 31 

As an example of assigning the Ontel program functions PFB9 through PFB15 for use with visual 
mode from the Ontel terminal, the following editor initialization file could be constructed. 

$CONTROL *MSOURCE* FUNCTION F5 99 
$CONTROL *MSOURCE* FUNCTION F6 9A 
$CONTROL *MSOURCE* FUNCTION F7 9B 
$CONTROL *MSOURCE* FUNCTION DE 9C 
$CONTROL *MSOURCE* FUNCTION DA 9D 

Visual Mode 113 



MTS 18: The MTS File Editor 
February 1988 

$CONTROL *MSOURCE* FUNCTION DC 9E 

$CONTROL *MSOURCE* FUNCTION FE 9F 

VPF 25=VSPLIT 

VPF 26=RENUMBER 

VPF 27=COPY * TO * 

VPF 28=LINE *VT COUNT=-100 

VPF 29=LINE *VT COUNT=100 

VPF 30=LINE *VT COUNT=-200 

VPF 31=LINE *VT COUNT=200 

In the above example, the $CONTROL *MSOURCE* FUNCTION command redefines the shifted 
program-function keys PF1 through PF7 across the top row of the keyboard to execute Ontel program 
functions PFB9 through PFB15 instead of the default Ontel program functions PFA1 through PFA7. 
Keys PFO and PF8 and the unshifted PF1 through PF7 keys are unchanged. These keys are 
subsequently assigned by the VPF command to the editor visual program functions VPF 25 through 
VPF 31. By issuing the %PAD=PFKEYS device command, the user will then have available 32 
different visual program functions for use with visual mode, VPF through VPF 24 on the numeric pad 
and VPF 25 through VPF 3 1 along the top row of the keyboard. 
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USING VISUAL MODE WITH THE ONTEL AMIGO 



The keyboard layout for the Ontel Amigo terminal is the same as for the IBM PC. 

The movement of the cursor is controlled by the CURSOR-RIGHT, CURSOR-LEFT, CURSOR-UP, 
and CURSOR-DOWN keys. These keys are labelled with arrows. Movement of the cursor is also 
controlled by the TAB, HOME, and RETURN keys. 

The following keys on the Ontel Amigo have special functions in visual mode. The actions of these 
keys are controlled only by the terminal routines and not by the editor program itself. 



Amigo Key 

Ins 

Del 

SHIFT-Del 

SHIFT-Bkspc («-) 

Esc 

SHIFT-Esc 

SHIFT-Home 



Effect 

Enter or exit insertion mode (toggle switch) 

Delete the character at the cursor 

Delete the word at the cursor 

Delete all characters to the right of the cursor 

Discard all current line changes 

Discard all current screen changes 

Move cursor to work field 



Along the left side of the keyboard is the program-function pad. These ten keys are called 
program-function keys and are labelled Fl through F10. Each program-function key has four Amigo 
program functions associated with it, one for each of the four possible key positions (unshifted-Fx, 
SHIFT-Fx, CTRL-Fx, and CTRL-SHIFT-Fx). These Amigo program functions are named PFAO 
through PFA15, PFBO through PFB15, and PFCO through PFC8. 

Normally (when not in visual mode), the program-function keys execute terminal device commands. 
In visual mode, each of the program-function keys is assigned to an editor visual program function 
(VPF) for visual-mode editing. These visual program functions in turn are assigned to visual-mode 
commands. The default key assignments for the Ontel Amigo terminal are as follows: 



VPF 


Amigo Key 


Amigo PF 


Default Assignment 


-2 


CTRL-C 


_ 


VEXITED_WORK 


-1 


CTRL-E 


- 


VEXIT 





PrtSc 


PFAO 


VUPDATE 


1 


Fl 


PFA1 


LINE *VT COUNT=-10 


2 


F2 


PFA2 


VPFB 


3 


F3 


PFA3 


VMEMORY 1 


4 


F4 


PFA4 


LINE*VTCOUNT=10 


5 


F5 


PFA5 


VPFE 


6 


F6 


PFA6 


VMEMORY 2 


7 


F7 


PFA7 


LINE*VTCOUNT=l 


8 


F8 


PFA8 


VEXECUTE 


9 


F9 


PFA9 


VMEMORY 3 


10 


F10 


PFA10 


VINSERT 1 2 


11 


SHIFT-F1 


PFA11 


VEXTEND 


12 


SHIFT-F2 


PFA12 


VPREVIOUS 


13 


SHIFT-F3 


PFA13 


LINE *VT COUNT=-10 


14 


SHIFT-F4 


PFA14 


VPFB 


15 


SHIFT-F5 


PFA15 


VMEMORY 1 
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16 


SHIFT-F6 


PFBO 


LINE *VT COUNT=10 


17 


SHIFT-F7 


PFB1 


VPFE 


18 


SHIFT-F8 


PFB2 


VMEM0RY2 


19 


SHIFT-F9 


PFB3 


LINE*VTC0UNT=1 


20 


SHIFT-F10 


PFB4 


VEXECUTE 


21 


CTRL-F1 


PFB5 


VMEM0RY3 


22 


CTRL-F2 


PFB6 


VINSERT 1 2 


23 


CTRL-F3 


PFB7 


VEXTEND 


24 


CTRL-F4 


PFB8 


VPREVIOUS 


25 


CTRL-F5 


PFB9 


Undefined 


26 


CTRL-F6 


PFB10 


Undefined 


27 


CTRL-F7 


PFB11 


Undefined 


28 


CTRL-F8 


PFB12 


Undefined 


29 


CTRL-F9 


PFB13 


Undefined 


30 


CTRL-F10 


PFB14 


Undefined 


31 


CTRL-SHIFT-F1 


PFB15 


Undefined 


32 


CTRL-SHIFT-F2 


PFCO 


Undefined 


33 


CTRL-SHIFT-F3 


PFC1 


Undefined 


34 


CTRL-SHIFT-F4 


PFC2 


Undefined 


35 


CTRL-SHIFT-F5 


PFC3 


Undefined 


36 


CTRL-SHIFT-F6 


PFC4 


Undefined 


37 


CTRL-SHIFT-F7 


PFC5 


Undefined 


38 


CTRL-SHIFT-F8 


PFC6 


Undefined 


39 


CTRL-SHIFT-F9 


PFC7 


Undefined 


40 


CTRL-SHIFT-F10 


PFC8 


Undefined 



Note that the default assignments for editor visual program functions (VPFs) 1 through 12 are the 
same as for 13 through 24. Editor VPFs 25 through 40 are initially undefined, but they may be defined 
by the user (see the section "Reassigning Amigo Visual Program Functions" below). 

Reassigning Amigo Visual Program Functions 



The example below illustrates how the editor visual program functions may be reassigned to make 
the Amigo program-function pad more versatile. 



VPF 1=VPFB 

VPF 2=VPFE 

VPF 3=VEXECUTE 

VPF 4=VSPLIT 

VPF 5=VINSERT 1 2 

VPF 6=VEXTEND 

VPF 7=VMEMORY 1 

VPF 8=VMEMORY 2 

VPF 9=VMEMORY 3 

VPF 10=VPREVIOUS 

VPF 11=LINE *VT COUNT=-l 

VPF 12=LINE *VT COUNT=l 

VPF 13=LINE *VT COUNT=-10 

VPF 14=LINE *VT COUNT=10 

VPF 15=LINE *VT COUNT=-100 

VPF 16=LINE *VT COUNT=100 

VPF 17=LINE *VT COUNT=-1000 

VPF 18=LINE *VT COUNT=1000 

VPF 19=LINE *F 

VPF 20=LINE *L 



(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 



sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 



Fl 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 



(PFA1) 
( PFA2 ) 
( PFA3 ) 
( PFA4 ) 
( PFA5 ) 
( PFA6 ) 
( PFA7 ) 
(PFA8) 
( PFA9 ) 
F10 (PFA1 
SHIFT-F1 
SHIFT-F2 
SHIFT -F3 
SHIFT -F4 
SHIFT- F5 
SHIFT- F6 
SHIFT -F7 
SHIFT- F8 
SHIFT-F9 
SHIFT-F10 



) 
) 
) 
) 
) 
) 
) 
) 
) 

0)) 

(PFA11) ) 
(PFA12) ) 
(PFA13)) 
(PFA14) ) 
(PFA15) ) 
(PFBO) ) 
(PFB1) ) 
(PFB2) ) 
(PFB3) ) 
(PFB4) ) 
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Editor visual program functions VPF 1 through VPF 12 are rearranged so that they more logically fit 
the Amigo program-function pad. Editor visual program functions VPF 13 through VPF20 are 
reassigned to different visual mode commands so that they do not duplicate VPF 1 through VPF 12. In 
this example, a selection of visual mode and normal edit commands is chosen so that the user may 
easily move around within the file. 

As a second example, the following editor initialization file will reassign part of the program 
functions to visual-mode commands, part to normal editor commands, and part to edit procedures to 
provide more advanced capabilities for the program-function pad. 

* 

* Define a procedure to execute a %GRAB device 

* command to initiate a second session 
* 

PROCEDURE ! GRAB 

UNLOCK 

$ CONTROL *MSOURCE* GRAB 

END 

* 

* Define a procedure to execute a %FLIP device 

* command to switch to the alternate session 
* 

PROCEDURE !FLIP 

UNLOCK 

$ CONTROL *MSOURCE* FLIP 

END 

* 

* Define a procedure to set variable A 

* to beginning line for MOVE after 

* moving the cursor to desired line 
* 

PROCEDURE ! SETA 

LET A=* 

END 

* 

* Set variable B to ending line for MOVE 

* after moving the cursor to desired line 
* 

PROCEDURE ! SETB 

LET B=* 

END 

* 

* Define a procedure to clear work area 

* before executing a VPFB command 
* 

PROCEDURE ! VPFB 

LET ED_WORK= ' ' 

VPFB 

END 

* 

* Redefine some PF keys 
* 

VPF 21=!GRAB (reassign CTRL-F1 (PFB5) ) 

VPF 22=!FLIP (reassign CTRL-F2 (PFB6) ) 

VPF 23=! SETA (reassign CTRL-F3 (PFB7) ) 

VPF 24=! SETB (reassign CTRL-F4 (PFB8) ) 

VPF 25=MOVE A B TO * (reassign CTRL-F5 (PFB9)) 

VPF 26=COMBINE * *N LEN=65 (reassign CTRL-F6 (PFB10)) 

Vpf 27=COPY * TO * (reassign CTRL-F7 (PFB11)) 

VPF 28=RENUMBER (reassign CTRL-F8 (PFB12)) 
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VPF 29=!VPFB (reassign CTRL-F9 (PFB13)) 

VPF 30=VPFE (reassign CTRL-F10 (PFB14) ) 

The above example illustrates how edit procedures may be used to execute terminal device commands 
and more complex editor commands. PFB5 and PFB6 have been reassigned to execute the %GRAB 
and %FLIP terminal device commands. These commands are executed via the MTS $CONTROL 
command (see MTS Volumes 1 and 4 for further details about issuing terminal device commands via 
the $CONTROL command). The edit UNLOCK command writes the current changes on the screen 
into the edit file and unlocks the file before the device command is executed. PFB7, PFB8, and PFB9 
have been reassigned to work in concert to easily move lines in the file from one location to another. 
PFB7 and PFB8 specify the beginning and ending bounds of the lines to be moved and PFB9 moves the 
text to the location specified by the current position of the cursor. PFB10 has been reassigned to the 
COMBINE command to combine the line pointed to by the cursor with the next line; the resultant lines 
are limited to 65 characters. PFB11 is reassigned to the COPY command to duplicate the line pointed 
to by the cursor. PFB12 is reassigned to the RENUMBER command. PFB13 has altered the VPFB 
command so that the work area is emptied before the insertion is performed. 

Redefining the Amigo Keyboard 

The Ontel Amigo terminal supports a total of 48 Ontel program functions, named PFAO through 
PFA15, PFBO through PFB15, and PFCO through PFC15. By default, program-function keys FO 
through F10 are defined as Amigo program functions PFAO through PFA15, PFBO through PFB15, and 
PFCO through PFC8. The other Ontel program functions PFC9 through PFC15 must be assigned to 
specific terminal keys by the user. 

The %FUNCTION device command may be used to assign the Amigo program functions. The 
%FUNCTION device command is given in the form 

%FUNCTIONnm 

where "n" is a hexadecimal value describing the key to be reassigned and "m" is a hexadecimal value 
describing the function to be assigned to the key. 

The hexadecimal values for program-function keys FO through F10 on the program-function pad are 
as follows: 

Hex Value Hex Value 

Key Unshifted Shifted 

Fl 80 90 

F2 81 91 

F3 82 92 

F4 83 93 

F5 84 94 

F6 85 95 

F7 86 96 

F8 87 97 

F9 88 98 

F10 89 99 

The hexadecimal values for the keys on the Amigo numeric pad are as follows: 
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Hex Value 


Hex Value 


CTRLed 


CTRL /Shifted 


A0 


BO 


Al 


Bl 


A2 


B2 


A3 


B3 


A4 


B4 


A5 


B5 


A6 


B6 


A7 


B7 


A8 


B8 


A9 


B9 
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Hex Value 


Hex Value 


Hex Value 


Hex Value 


Key 


Unshifted 


Shifted 


CTRLed 


CTRL /Shifted 


(Ins) 


CO 


DO 


EO 


FO 


1 (End) 


CI 


Dl 


El 


Fl 


2 


C2 


D2 


E2 


F2 


3 (PgDn) 


C3 


D3 


E3 


F3 


4 


C4 


D4 


E4 


F4 


5 


C5 


D5 


E5 


F5 


6 


C6 


D6 


E6 


F6 


7 (Home) 


C7 


D7 


E7 


F7 


8 


C8 


D8 


E8 


F8 


9 (PgUp) 


C9 


D9 


E9 


F9 


Scrl Lock 


CA 


DA 


EA 


FA 


- 


CB 


DB 


EB 


FB 


PrtSc 


CC 


- 


- 


- 


+ 


CD 


DC 


EC 


FC 


. (Del) 


CE 


DD 


ED 


FD 



The hexadecimal values for the Ontel program functions are as follows: 



Program Function 

PFAO through PFA15 
PFBO through PFB 15 
PFCO through PFC 15 



Hex Value 

80 through 8F 
90 through 9F 
Al through AF 



Editor VPF 

through 15 
16 through 31 
32 through 48 



As an example of assigning the Amigo program functions PFB8 through PFCO for use with visual 
mode from the Ontel Amigo terminal, the following editor initialization file could be constructed. 

$CONTROL *MSOURCE* FUNCTION CI Al 

$CONTROL *MSOURCE* FUNCTION C2 A2 

$CONTROL *MSOURCE* FUNCTION C3 A3 

$CONTROL *MSOURCE* FUNCTION C4 A4 

$CONTROL *MSOURCE* FUNCTION C5 A5 

$CONTROL *MSOURCE* FUNCTION C6 A6 

$CONTROL *MSOURCE* FUNCTION C7 A7 

$CONTROL *MSOURCE* FUNCTION C8 A8 

$CONTROL *MSOURCE* FUNCTION C9 A9 

VPF 31=LINE *VT COUNT=100 (reassign 1 key (PFC1) 

VPF 32=LINE *VT COUNT=200 (reassign 2 key (PFC2) 

VPF 33=LINE *VT COUNT=300 (reassign 3 key (PFC3) 

VPF 34=LINE *VT COUNT=400 (reassign 4 key (PFC4) 

VPF 35=LINE *VT COUNT=500 (reassign 5 key (PFC5) 

VPF 36=LINE *VT COUNT=600 (reassign 6 key (PFC6) 

VPF 37=LINE *VT COUNT=700 (reassign 7 key (PFC7) 

VPF 38=LINE *VT COUNT=800 (reassign 8 key (PFC8) 

VPF 39=LINE *VT COUNT=9 00 (reassign 9 key (PFC9) 

In the above example, the $CONTROL *MSOURCE* FUNCTION command redefines the Ontel Amigo 
numeric pad keys to Amigo program functions PFC1 through PFC9. These keys are subsequently 
assigned by the VPF command to the editor visual program functions VPF 31 through VPF 39. This 
converts the numeric-pad number keys into keys that advance the screen by a count of 
(key-number*100). 
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USING VISUAL MODE WITH THE IBM PC 

The keyboard layout for the IBM PC and other IBM-compatible terminals such as the Zenith 150 is 
as follows: 



Return, 



Break 



F1 


F2 


F3 


F4 


FS 


F6 


F7 


FS 


FS 


F10 



Tab 



E«C 



EEEEIDOEBEI] 



Backspace 



!□□□□□□£ 



Ctrl 



Shift 

4M 



Enter, 



7 



]□□□□□□□□□□!£ 



Alt 



Cap* Lock 



Num 

Lock 



7 
Home 



scroll/ sy» 
Lock rl|B»q 



9 

hup 



PgDn 



PrtSc 



The IBM PC Keyboard 

The basic movement of the cursor is controlled by the CURSOR-RIGHT, CURSOR-LEFT, 
CURSOR-UP, and CURSOR-DOWN keys. These keys are labelled with arrows. The movement of 
the cursor may also be controlled by other keys as listed in the table below. 



IBM -PC Key 

Return 

CTRL-IorTab 

CTRL-0 or SHIFT-Tab 

CTRL-F 

CTRL-R 

CTRL-AorCTRL-Y 

CTRL-Z 

Home 

CTRL-B 



Effect 

Move cursor to next line or field 

Move cursor to next tab position 

Move cursor to previous tab position 

Move cursor to next word 

Move cursor to previous word 

Move cursor to beginning of line or beginning of previous line 

Move cursor to end of line or end of next line 

Move cursor to upper left corner 

Move cursor to work field 



The following keys on the IBM PC have special functions in visual mode. The actions of these keys 
are controlled only by the terminal routines and not by the editor program itself. 
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IBM-PC Key 

Ins 

DelorCTRL-D 

Backspace (<-) 

CTRL-X 

CTRL-U 

CTRL-V 



Effect 



Enter or exit insertion mode (toggle switch) 

Delete the character at the cursor 

Delete the previous character or CTRL-H 

Delete the entire line 

Delete all characters to the right of the cursor 

Discard current screen changes 



Along the left side of the keyboard is the program-function pad. These ten keys are called 
program-function keys and are labelled Fl through F10. Each program-function key has four 
program functions associated with it, one for each of the four possible key positions (unshifted-Fx, 
SHIFT-Fx, ALT-Fx, and CTRL-Fx). These program functions are supported by the Window program 
and are named PF1 through PF40. 

Normally (when not in visual mode), the program-function keys execute terminal device commands. 
In visual mode, each of the program-function keys is assigned to an editor visual program function 
(VPF) for visual-mode editing. These visual program functions in turn are assigned to visual-mode 
commands. The default key assignments for the IBM PC terminal are as follows: 



VPF 


IBM PC Key 


Window PF 


Default Assignment 


-2 


CTRL-C 


PFC 


VEXITED_WORK 


-1 


CTRL-E 


PFE 


VEXIT 





End 


PFO 


VUPDATE 


1 


Fl 


PF1 


LINE *VT COUNT=-10 


2 


F2 


PF2 


VPFB 


3 


F3 


PF3 


VMEMORY 1 


4 


F4 


PF4 


LINE*VTCOUNT=10 


5 


F5 


PF5 


VPFE 


6 


F6 


PF6 


VMEMORY 2 


7 


F7 


PF7 


LINE*VTCOUNT=l 


8 


F8 


PF8 


VEXECUTE 


9 


F9 


PF9 


VMEMORY 3 


10 


F10 


PF10 


VINSERT 1 2 


11 


ALT-F1 


PF11 


VEXTEND 


12 


ALT-F2 


PF12 


VPREVIOUS 


13 


ALT-F3 


PF13 


LINE *VT COUNT=-10 


14 


ALT-F4 


PF14 


VPFB 


15 


ALT-F5 


PF15 


VMEMORY 1 


16 


ALT-F6 


PF16 


LINE*VTCOUNT=10 


17 


ALT-F7 


PF17 


VPFE 


18 


ALT-F8 


PF18 


VMEMORY 2 


19 


ALT-F9 


PF19 


LINE*VTCOUNT=l 


20 


ALT-F10 


PF20 


VEXECUTE 


21 


SHIFT-F1 


PF21 


VMEMORY 3 


22 


SHIFT-F2 


PF22 


VINSERT 1 2 


23 


SHIFT-F3 


PF23 


VEXTEND 


24 


SHIFT-F4 


PF24 


VPREVIOUS 


25 


SHIFT-F5 


PF25 


Undefined 


26 


SHIFT-F6 


PF26 


Undefined 


27 


SHIFT-F7 


PF27 


Undefined 
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28 




SHIFT-F8 


PF28 


Undefined 


29 




SHIFT-F9 


PF29 


Undefined 


30 




SHIFT-F10 


PF30 


Undefined 


31 




CTRL-F1 


PF31 


Undefined 


32 




CTRL-F2 


PF32 


Undefined 


33 




CTRL-F3 


PF33 


Undefined 


34 




CTRL-F4 


PF34 


Undefined 


35 




CTRL-F5 


PF35 


Undefined 


36 




CTRL-F6 


PF36 


Undefined 


37 




CTRL-F7 


PF37 


Undefined 


38 




CTRL-F8 


PF38 


Undefined 


39 




CTRL-F9 


PF39 


Undefined 


40 




CTRL-F10 


PF40 


Undefined 



Note that the default assignments for editor visual program functions (VPFs) 1 through 12 are the 
same as for 13 through 24. Editor VPFs 25 through 40 are initially undefined, but they may be defined 
by the user (see the section "Reassigning IBM PC Visual Program Functions" below). 

Reassigning IBM PC Visual Program Functions 



The example below illustrates how the editor visual program functions may be reassigned to make 
the IBM PC program-function pad more versatile. 



VPF 1=VPFB 

VPF 2=VPFE 

VPF 3=VEXECUTE 

VPF 4=VSPLIT 

VPF 5=VINSERT 1 2 

VPF 6=VEXTEND 

VPF 7=VMEMORY 1 

VPF 8=VMEMORY 2 

VPF 9=VMEMORY 3 

VPF 10=VPREVIOUS 

VPF 11=LINE *VT COUNT=-l 

VPF 12=LINE *VT COUNT=l 

VPF 13=LINE *VT COUNT=-10 

VPF 14=LINE *VT COUNT=10 

VPF 15=LINE *VT COUNT=-100 

VPF 16=LINE *VT COUNT=100 

VPF 17=LINE *VT COUNT=-1000 

VPF 18=LINE *VT COUNT=1000 

VPF 19=LINE *F 

VPF 20=LINE *L 



(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 



sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 



Fl 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

F10 

ALT 

ALT 

ALT 

ALT 

ALT 

ALT 

ALT 

ALT 

ALT 

ALT 



(PF1 
(PF2 
(PF3 
(PF4 
(PF5 
(PF6 
(PF7 
(PF8 
(PF9 
(PF 
■Fl 
-F2 
-F3 
■F4 
■F5 
■F6 
-F7 
■F8 
■F9 
-F10 



)) 
)) 
)) 
)) 
)) 
)) 
)) 
)) 
)) 

10)) 
(PF11)) 
(PF12)) 
(PF13)) 
(PF14)) 
(PF15)) 
(PF16)) 
(PF17)) 
(PF18)) 
(PF19)) 
(PF20) ) 



Editor visual program functions VPF 1 through VPF 12 are rearranged so that they more logically fit 
the IBM PC program-function pad. Editor visual program functions VPF 13 through VPF 20 are 
reassigned to different visual mode commands so that they do not duplicate VPF 1 through VPF 12. In 
this example, a selection of visual mode and normal edit commands is chosen so that the user may 
easily move around within the file. 

As a second example, the following editor initialization file will reassign part of the program 
functions to visual-mode commands, part to normal editor commands, and part to edit procedures to 
provide more advanced capabilities for the program-function pad. 
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* Define a procedure to execute a %GRAB device 

* command to initiate a second session 
* 

PROCEDURE ! GRAB 

UNLOCK 

$ CONTROL *MSOURCE* GRAB 

END 

* 

* Define a procedure to execute a %FLIP device 

* command to switch to the alternate session 



PROCEDURE !FLIP 

UNLOCK 

$ CONTROL *MSOURCE* FLIP 

END 

* 

* Define a procedure to set variable A 

* to beginning line for MOVE after 

* moving the cursor to desired line 
* 

PROCEDURE ! SETA 

LET A=* 

END 

* 

* Set variable B to ending line for MOVE 

* after moving the cursor to desired line 



PROCEDURE 
LET B=* 
END 



!SETB 



* Define a procedure to c 

* before executing a VPFB 
* 

PROCEDURE ! VPFB 

LET ED_WORK= ■ ' 

VPFB 

END 

* 

* Redefine some PF keys 



lear work area 
command 



VPF 


21=! GRAB 


VPF 


22=!FLIP 


VPF 


23=! SETA 


VPF 


24=!SETB 


VPF 


25=MOVE A B TO * 


VPF 


26=COMBINE * *N LEN 



:65 



VPF 27=COPY * TO 
VPF 28=RENUMBER 
VPF 29=! VPFB 
VPF 30=VPFE 



(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 



sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 



SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 



Fl 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
F10 



(PF21)) 
(PF22)) 
(PF23)) 
(PF24)) 
(PF25)) 
(PF26)) 
(PF27) ) 
(PF28)) 
(PF29)) 
(PF30)) 



The above example illustrates how edit procedures may be used to execute terminal device commands 
and more complex editor commands. PF21 and PF22 have been reassigned to execute the %GRAB 
and %FLIP terminal device commands. These commands are executed via the MTS $CONTROL 
command (see MTS Volumes 1 and 4 for further details about issuing terminal device commands via 
the $CONTROL command). The edit UNLOCK command writes the current changes on the screen 
into the edit file and unlocks the file before the device command is executed. PF23, PF24, and PF25 
have been reassigned to work in concert to easily move lines in the file from one location to another. 
PF23 and PF24 specify the beginning and ending bounds of the lines to be moved and PF25 moves the 
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text to the location specified by the current position of the cursor. PF26 has been reassigned to the 
COMBINE command to combine the line pointed to by the cursor with the next line; the resultant lines 
are limited to 65 characters. PF27 is reassigned to the COPY command to duplicate the line pointed to 
by the cursor. PF28 is reassigned to the RENUMBER command. PF29 has altered the VPFB 
command so that the work area is emptied before the insertion is performed. 

Redefining the IBM PC Keyboard 

The IBM PC terminal supports a total of 126 Window program functions, named PF1 through 
PF100 and PFA through PFZ. These program functions are assigned to the keyboard as follows: 

PF1-PF10 Function keys F1-F10 

PF11-PF20 ALT-Function keys F1-F10 

PF21-PF30 SHIFT-Function keys F1-F10 

PF31-PF40 CTRL-Function keys F1-F10 

PF41-PF44 Numeric Pad keys 1-4 

PF45 Del(.)key 

PF46-PF49 Numeric Pad keys 6-9 

PF50 Ins (0) key 

PF5 1 CTRL-Numeric Pad key 1 

PF52 CTRL-PrtSckey 

PF53-PF54 CTRL-Numeric Pad keys 3-4 

PF55 Non-existent 

PF56-PF57 CTRL-Numeric Pad keys 6-7 

PF58 CTRL-Break 

PF59 CTRL-Numeric Pad key 9 

PF60 Non-existent 

PF61-PF70 ALT-1 through ALT-0 (nonnumeric pad) 

PF71-PF72 ALT— and ALT-= 

PF73-PF98 ALT-alphabetic keys (1 to r, t to b) 

PF99-PF100 Non-existent 

PFA-PFZ CTRL-alphabetic keys (a to z) 

The %VPF device command may be used to assign the Window program functions. The %VPF 
device command is given in the form 

%VPFn=%!m 

where "n" is the Window program function number corresponding to a particular key and "m" is an 
editor visual program function (VPF) number (from through 99) Although the Window program 
function number need not be the same as the editor VPF number, it is recommended for the sake of 
clarity and simplicity that the Window and editor VPF numbers be the same. 

Note: Window program functions PF55, PF60, PF99, PF100, and PFA through PFZ currently are 
not available for assignment. 

The Window command %VPF? may be given to display all of the current assignments of editor VPFs 
to Window program functions. 

As an example of assigning the Window program functions PF41 through PF49 for use with visual 
mode from the IBM PC terminal, the following editor initialization file could be constructed. 
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$CONTROL *MSOURCE* VPF 41=%! 41 
$ CONTROL *MSOURCE* VPF 42=%! 42 
$ CONTROL *MSOURCE* VPF 43=%! 43 
$CONTROL *MSOURCE* VPF 44=%! 44 
$ CONTROL *MSOURCE* VPF 45=%! 45 
$ CONTROL *MSOURCE* VPF 46=%! 46 
$CONTROL *MSOURCE* VPF 47=%! 47 
$ CONTROL *MSOURCE* VPF 48=%! 48 
$ CONTROL *MSOURCE* VPF 49=%! 49 
VPF 41=LINE *VT COUNT=100 (reassign 
VPF 42=LINE *VT COUNT=200 (reassign 
VPF 43=LINE *VT COUNT=300 (reassign 
VPF 44=LINE *VT COUNT=400 (reassign 
VPF 45=LINE *VT COUNT=500 (reassign 
VPF 46=LINE *VT COUNT=600 (reassign 
VPF 47=LINE *VT COUNT=700 (reassign 
VPF 48=LINE *VT COUNT=800 (reassign 
VPF 49=LINE *VT COUNT=9 00 (reassign 



MTS 18: The MTS File Editor 
February 1988 



key) 
key) 
key) 
key) 
. key) 

6 key) 

7 key) 

8 key) 

9 key) 



In the above example, the $CONTROL *MSOURCE* VPF command assigns the IBM PC numeric pad 
keys to editor visual program functions VPF 41 through VPF 49. Then by issuing the editor VPF 
commands, the numeric-pad keys are converted into keys that advance the screen by a count of 
(key-number* 100). 
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USING VISUAL MODE WITH THE ZENITH 100 

The keyboard layout for the Zenith 100 terminals is as follows: 



HQHH!0SaapHE!HH 



SMffiHSBTOETOEm 



( *5* ■■ - ' V , . y, A „ A jy, 

aCZDBM 



gMUBPiP 



BBEBEEdB 



c 

1 <1 


V 


~v 


B 

i — k 


H 







The Zenith 100 Keyboard 

The basic movement of the cursor is controlled by the CURSOR-RIGHT, CURSOR-LEFT, 
CURSOR-UP, and CURSOR-DOWN keys. These keys are labelled with arrows. The movement of 
the cursor may also be controlled by other keys as listed in the table below. 



Z-lOOKey 

Return 

CTRL-IorTab 

CTRL-AorCTRL-Y 

CTRL-Z 

Home 

CTRL-B 



Effect 

Move cursor to next line or field 

Move cursor to next tab position 

Move cursor to beginning of line or beginning of previous line 

Move cursor to end of line or end of next line 

Move cursor to upper left corner 

Move cursor to work field 



The following keys on the Zenith 100 have special functions in visual mode. The actions of these 
keys are controlled only by the terminal routines and not by the editor program itself. 



Z-lOOKey 

ICHR 

DCHR 

BACKSPACE 

CTRL-XorDELLINE 

CTRL-U 

CTRL-V 



Effect 

Enter or exit insertion mode (toggle switch) 

Delete the character at the cursor 

Delete the previous character 

Delete the entire line 

Delete all characters to the right of the cursor 

Discard current screen changes 



Along the top of the keyboard is the program-function pad. These twelve keys are called 
program-function keys and are labelled Fl through F12. Each program-function key has two program 
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functions associated with it, one for each of the two possible key positions (unshifted-Fx and SHIFT-Fx) 
These program functions are supported by the Window program and are named PF1 through PF24. 

Normally (when not in visual mode), the program-function keys execute terminal device commands. 
In visual mode, each of the program-function keys is assigned to an editor visual program function 
(VPF) for visual-mode editing. These visual program functions in turn are assigned to visual-mode 
commands. The default key assignments for the Zenith 100 terminal are as follows: 



VPF 


Z- 100 Key 


Window PF 


Default Assignment 


-2 


CTRL-C 


PFC 


VEXITED_WORK 


-1 


CTRL-E 


PFE 


VEXIT 





- 


- 


VUPDATE 


1 


Fl 


PF1 


LINE *VT COUNT=-10 


2 


F2 


PF2 


VPFB 


3 


F3 


PF3 


VMEMORY 1 


4 


F4 


PF4 


LINE*VTCOUNT=10 


5 


F5 


PF5 


VPFE 


6 


F6 


PF6 


VMEMORY 2 


7 


F7 


PF7 


LINE*VTCOUNT=l 


8 


F8 


PF8 


VEXECUTE 


9 


F9 


PF9 


VMEMORY 3 


10 


F10 


PF10 


VINSERT 1 2 


11 


Fll 


PF11 


VEXTEND 


12 


F12 


PF12 


VPREVIOUS 


13 


SHIFT-F1 


PF13 


LINE *VT COUNT=-10 


14 


SHIFT-F2 


PF14 


VPFB 


15 


SHIFT-F3 


PF15 


VMEMORY 1 


16 


SHIFT-F4 


PF16 


LINE*VTCOUNT=10 


17 


SHIFT-F5 


PF17 


VPFE 


18 


SHIFT-F6 


PF18 


VMEMORY 2 


19 


SHIFT-F7 


PF19 


LINE*VTCOUNT=l 


20 


SHIFT-F8 


PF20 


VEXECUTE 


21 


SHIFT-F9 


PF21 


VMEMORY 3 


22 


SHIFT-F10 


PF22 


VINSERT 1 2 


23 


SHIFT-F11 


PF23 


VEXTEND 


24 


SHIFT-F12 


PF24 


VPREVIOUS 



Note that the default assignments for editor visual program functions (VPFs) 1 through 12 are the 
same as for 13 through 24. 



Reassigning Zenith 100 Visual Program Functions 

The example below illustrates how the editor visual program functions may be reassigned to make 
the Zenith 100 program-function pad more versatile. 



VPF 


1=VPFB 


VPF 


2=VPFE 


VPF 


3=VEXECUTE 


VPF 


4=VSPLIT 


VPF 


5=VINSERT 1 


VPF 


6=VEXTEND 


VPF 


7=VMEMORY 1 



(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 



sign 
sign 
sign 
sign 
sign 
sign 
sign 



Fl 
F2 
F3 
F4 
F5 
F6 
F7 



(PF1)) 
(PF2)) 
(PF3)) 
(PF4) ) 
(PF5)) 
(PF6)) 
(PF7)) 
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VPF 8=VMEM0RY 2 

VPF 9=VMEM0RY 3 

VPF 10=VPREVIOUS 

VPF 11=VCURS0R WORK 

VPF 12=VUPDATE 

VPF 13=LINE *F 

VPF 14=LINE *L 

VPF 15=LINE *VT COUNT= - 1 

VPF 16=LINE *VT COUNT=l 

VPF 17=LINE *VT COUNT=-10 

VPF 18=LINE *VT COUNT=10 

VPF 19=LINE *VT COUNT=-100 

VPF 20=LINE *VT COUNT=100 

VPF 21=LINE *VT COUNT=-1000 

VPF 22=LINE *VT COUNT=1000 

VPF 23=VCURSOR WORK 

VPF 24=VUPDATE 



(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 



sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 



F8 (PF8)) 
F9 (PF9)) 
F10 (PF10) 
Fll (PF11) 
F12 (PF12) 



SHIFT-F1 
SHIFT -F2 
SHIFT -F3 
SHIFT- F4 
SHIFT-F5 
SHIFT- F6 
SHIFT-F7 
SHIFT- F8 
SHIFT- F9 
SHIFT-F10 
SHIFT-F11 
SHIFT-F12 



) 

) 

) 

PF13)) 

PF14)) 

PF15)) 

PF16)) 

PF17) ) 

PF18)) 

PF19)) 

PF20)) 

PF21)) 

(PF22) ) 

(PF23)) 

(PF24) ) 



Editor visual program functions VPF 1 through VPF 12 are rearranged so that they more logically fit 
the Zenith 100 program-function pad. Editor visual program functions VPF 13 through VPF 22 are 
reassigned to different visual mode commands so that they do not duplicate VPF 1 through VPF 12. In 
this example, a selection of visual mode and normal edit commands is chosen so that the user may 
easily move around within the file. 

As a second example, the following editor initialization file will reassign part of the program 
functions to visual-mode commands, part to normal editor commands, and part to edit procedures to 
provide more advanced capabilities for the program-function pad. 

* 

* Define a procedure to execute a %GRAB device 

* command to initiate a second session 
* 

PROCEDURE ! GRAB 

UNLOCK 

$ CONTROL *MSOURCE* GRAB 

END 

* 

* Define a procedure to execute a %FLIP device 

* command to switch to the alternate session 
* 

PROCEDURE !FLIP 

UNLOCK 

$ CONTROL *MSOURCE* FLIP 

END 

* 

* Define a procedure to set variable A 

* to beginning line for MOVE after 

* moving the cursor to desired line 



PROCEDURE 
LET A=* 
END 



!SETA 



* Set variable B to ending line for MOVE 

* after moving the cursor to desired line 



PROCEDURE 
LET B=* 
END 



!SETB 
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* Define a procedure to c 

* before executing a VPFB 
* 

PROCEDURE ! VPFB 

LET ED_WORK= ■ ' 

VPFB 

END 

* 

* Redefine some PF keys 
* 

VPF 15=! GRAB 

VPF 16=! FLIP 

VPF 17=! SETA 

VPF 18=!SETB 

VPF 19=MOVE A B TO * 

VPF 20=COMBINE * *N LEN=6. C 

VPF 21=COPY * TO * 

VPF 22=RENUMBER 

VPF 23=! VPFB 

VPF 24=VPFE 



lear work area 
command 



(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 
(reas 



sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 
sign 



SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 



F3 
F4 
F5 
F6 
F7 
F8 
F9 
■F10 
Fll 
F12 



(PF15)) 
(PF16)) 
(PF17)) 
(PF18)) 
(PF19)) 
(PF20)) 
(PF21)) 
(PF22) ) 
(PF23)) 
(PF24) ) 



The above example illustrates how edit procedures may be used to execute terminal device commands 
and more complex editor commands. PF15 and PF16 have been reassigned to execute the %GRAB 
and %FLIP terminal device commands. These commands are executed via the MTS $CONTROL 
command (see MTS Volumes 1 and 4 for further details about issuing terminal device commands via 
the $CONTROL command). The edit UNLOCK command writes the current changes on the screen 
into the edit file and unlocks the file before the device command is executed. PF17, PF18, and PF19 
have been reassigned to work in concert to easily move lines in the file from one location to another. 
PF17 and PF18 specify the beginning and ending bounds of the lines to be moved and PF19 moves the 
text to the location specified by the current position of the cursor. PF20 has been reassigned to the 
COMBINE command to combine the line pointed to by the cursor with the next line; the resultant lines 
are limited to 65 characters. PF21 is reassigned to the COPY command to duplicate the line pointed to 
by the cursor. PF22 is reassigned to the RENUMBER command. PF23 has altered the VPFB 
command so that the work area is emptied before the insertion is performed. 



Redefining the Zenith 100 Keyboard 

The Zenith 100 terminal supports a total of 65 Window program functions, named PF1 through 
PF39 and PFA through PFZ. These program functions are assigned to the keyboard as follows: 



PF1-PF12 

PF13-PF24 

PF25 

PF26 

PF27 

PF28 

PF29 

PF30-PF39 

PF31 

PF32 

PF33 

PF34 

PF35 

PF36 



Function keys F1-F12 

SHIFT-Function keys F1-F12 

Function key 

SHIFT-Function key 

SHIFT-BREAK 

HELP 

Non-existent 

Numeric Pad keys 0-9 

INS LINE 

Down Arrow ( i ) 

DEL LINE 

Left Arrow («-) 

HOME 

Right Arrow (-) 
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PF37 
PF38 
PF39 
PFA-PFZ 



ICHR 

Up Arrow ( t ) 

DCHR 

CTRL-Alphabetic keys (a-z) 



The %VPF device command may be used to assign the Window program functions. The %VPF 
device command is given in the form 

%VPF n=%! m 

where "n" is the Window program function number corresponding to a particular key and "m" is an 
editor visual program function (VPF) number (from through 99) Although the Window program 
function number need not be the same as the editor VPF number, it is recommended for the sake of 
clarity and simplicity that the Window and editor VPF numbers be the same. 

Note: Window program functions PF29, and PFA through PFZ currently are not available for 
assignment. 

As an example of assigning the Window program functions PF31 through PF39 for use with visual 
mode from the Zenith 100 terminal, the following editor initialization file could be constructed. 

$CONTROL *MSOURCE* VPF 31=%! 31 

$ CONTROL *MSOURCE* VPF 32=%! 32 

$ CONTROL *MSOURCE* VPF 33=%! 33 

$ CONTROL *MSOURCE* VPF 34=%! 34 

$ CONTROL *MSOURCE* VPF 35=%! 35 

$ CONTROL *MSOURCE* VPF 36=%! 36 

$CONTROL *MSOURCE* VPF 37=%! 37 

$ CONTROL *MSOURCE* VPF 38=%! 38 

$ CONTROL *MSOURCE* VPF 39=%! 39 

VPF 31=LINE *VT COUNT=100 (reassign 1 key) 

VPF 32=LINE *VT COUNT=200 (reassign 2 key) 

VPF 33=LINE *VT COUNT=300 (reassign 3 key) 

VPF 34=LINE *VT COUNT=400 (reassign 4 key) 

VPF 35=LINE *VT COUNT=500 (reassign 5 key) 

VPF 36=LINE *VT COUNT=600 (reassign 6 key) 

VPF 37=LINE *VT COUNT=700 (reassign 7 key) 

VPF 38=LINE *VT COUNT=800 (reassign 8 key) 

VPF 39=LINE *VT COUNT=9 00 (reassign 9 key) 

In the above example, the $CONTROL *MSOURCE* VPF command assigns the Zenith 100 numeric 
pad keys to editor visual program functions VPF 31 through VPF 39. Then by issuing the editor VPF 
commands, the numeric-pad keys are converted into keys that advance the screen by a count of 
(key-number* 100). 

The Window command %VPF? may be given to display all of the current assignments of editor VPFs 
to Window program functions. 
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USING VISUAL MODE WITH THE APPLE MACINTOSH 



The keyboard layout for the Apple Macintosh terminal is as follows: 



*** 


! 




3> 11* 

2 ||: 


jlge: 


17 ||9 




|( 
19 


1) 


i 


HI: 


[Backspace 


Tab 


Q 


w 


|E 1 


R 


l T ll ¥ 1 


U 


i 


1° 


l p II! Hi 1 




CapsLock IJA ||S II D || F 


.||. 


|J IIK 


|l 


D(I]r rn 


Shift 1 |Z 


X lie 


|v 


B 


3BE 


> 1 


1 1 


Shift 


t 


Option 


% 


II' II"" ll~* 


1 



Clear 


55 


/ 


* 


7 


8 


9 


- 


4 


5 


6 


+ 


1 


2 


3 


Enter 





■ 



The Apple Macintosh Keyboard 

The basic movement of the cursor is controlled by pressing the CTRL key (labelled with the 
quadrille symbol) in conjunction with the CURSOR-RIGHT, CURSOR-LEFT, CURSOR-UP, and 
CURSOR-DOWN keys (labelled with arrows). The cursor also may be moved by pressing the OPTION 
key and using the mouse to click the cursor to the desired location. The movement of the cursor may 
also be controlled by other keys as listed in the table below. 



Mac Key 

CTRL-H or Backsp 

CTRL-M or Return 

CTRL-IorTab 

CTRL-B 

CTRL-K 

CTRL-N 

CTRL-Z 

CTRL-T 

CTRL-V 



Effect 

Move cursor to previous character 

Move cursor to beginning of next line 

Move cursor to next tab position 

Move cursor to beginning of line or beginning of previous line 

Move cursor to beginning of previous line 

Move cursor to last column of line 

Move cursor to end of line or end of next line 

Move cursor to upper left corner 

Move cursor to work field 



The following keys on the Macintosh have special functions in visual mode. The actions of these 
keys are controlled only by the terminal routines and not by the editor program itself. 
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Mac Key 

CTRL-A 

CTRL-D 

CTRL-W 

CTRL-X 

CTRL-G 

CTRL-L 

CTRL-R 



Effect 

Enter or exit insertion mode (toggle switch) 

Delete the character at the cursor 

Delete the word at the cursor 

Delete all characters to the right of the cursor 

Discard current line changes 

Discard current screen changes 

Rewrite the screen (with changes) 



The Macintosh control program assigns Macintosh program functions (PFs) to several of the keys, 
primarily on the numeric pad keyboard. These are named PFO through PF17. These in turn are 
assigned to editor program functions VPF through VPF 17. The default key assignments for the 
Macintosh terminal are as follows: 



VPF 



Mac Key 



MacPF 



Default Assignment 



-2 


CTRL-C 


- 


VEXITED_WORK 


-1 


CTRL-E 


- 


VEXIT 





Numpad 1 


PFO 


VUPDATE 


1 


Numpad 1 


PF1 


LINE *VT COUNT=-10 


2 


Numpad 2 


PF2 


VPFB 


3 


Numpad 3 


PF3 


VMEMORY 1 


4 


Numpad 4 


PF4 


LINE*VTCOUNT=10 


5 


Numpad 5 


PF5 


VPFE 


6 


Numpad 6 


PF6 


VMEMORY 2 


7 


Numpad 7 


PF7 


LINE*VTCOUNT=l 


8 


Numpad 8 


PF8 


VEXECUTE 


9 


Numpad 9 


PF9 


VMEMORY 3 


10 


Numpad CLEAR 


PF10 


VINSERT 1 2 


11 


Numpad - 


PF11 


VEXTEND 


12 


Numpad + 


PF12 


VPREVIOUS 


13 


Numpad * 


PF13 


LINE *VT COUNT=-10 


14 


Numpad / 


PF14 


VPFB 


15 


Numpad , 


PF15 


VMEMORY 1 


16 


Numpad ENTER 


PF16 


LINE*VTCOUNT=10 


17 


Numpad . 


PF17 


VPFE 



Note that the default assignments for editor visual program functions (VPFs) 1 through 5 are the same 
as for 13 through 17. 

Reassigning Macintosh Visual Program Functions 

The example below illustrates how the editor visual program functions may be reassigned to make 
the Macintosh numeric pad more versatile. 



VPF 


0=LINE *VT COUNT=-10 


(reassign 





key) 


VPF 


1=LINE *VT COUNT=l 


(reassign 


1 


key) 


VPF 


2=LINE *VT COUNT=10 


(reassign 


2 


key) 


VPF 


3=LINE *VT COUNT=100 


(reassign 


3 


key) 


VPF 


4=VINSERT 1 2 


(reassign 


4 


key) 


VPF 


5=VEXTEND 


(reassign 


5 


key) 


VPF 


6=VSPLIT 


(reassign 


6 


key) 
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VPF 7=VPFB 

VPF 8=VPFE 

VPF 9=VEXECUTE 

VPF 10=VMEMORY 1 

VPF 11=VMEM0RY 2 

VPF 12=VMEM0RY 3 

VPF 13=VPREVI0US 

VPF 14=LINE *F 

VPF 15=LINE *L 

VPF 16=VUPDATE 

VPF 17=LINE *VT COUNT=-100 



(reassign 


7 key) 


(reassign 


8 key) 


(reassign 


9 key) 


(reassign 


CLEAR key) 


(reassign 


- key) 


(reassign 


+ key) 


(reassign 


* key) 


(reassign 


/ key) 


(reassign 


, key) 


(reassign 


ENTER) 


(reassign 


. key) 



Editor visual program functions VPF 1 through VPF 17 are rearranged so that they more logically fit 
the Macintosh numeric pad. Editor visual program functions VPF 13 through VPF 17 are reassigned 
to different visual mode commands so that they do not duplicate VPF 1 through VPF 5. In this 
example, a selection of visual mode and normal edit commands is chosen so that the user may easily 
move around within the file. 

As a second example, the following editor initialization file will reassign part of the program 
functions to visual-mode commands, part to normal editor commands, and part to edit procedures to 
provide more advanced capabilities for the program-function pad. 

* 

* Define a procedure to set variable A 

* to beginning line for MOVE after 

* moving the cursor to desired line 



PROCEDURE 
LET A=* 
END 



ISETA 



* Set variable B to ending line for MOVE 

* after moving the cursor to desired line 



PROCEDURE 
LET B=* 
END 



!SETB 



* Define a procedure to clear work area 

* before executing a VPFB command 



PROCEDURE ! VPFB 

LET ED_WORK= ■ ' 

VPFB 

END 

* 

* Redefine some PF keys 
* 

VPF 10=! SETA 

VPF 11=!SETB 

VPF 12=MOVE A B TO * 

VPF 13=COMBINE * *N LEN=65 

VPF 7= ! VPFB 



(reassign CLEAR key (PF10) ) 

(reassign - key (PF11) ) 

(reassign + key (PF12) ) 

(reassign * key (PF13)) 

(reassign 7 key (PF7) ) 



The above example illustrates how edit procedures may be used to execute terminal device commands 
and more complex editor commands. PF10, PF11, and PF12 have been reassigned to work in concert 
to easily move lines in the file from one location to another. PF10 and PF11 specify the beginning and 
ending bounds of the lines to be moved and PF12 moves the text to the location specified by the current 
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position of the cursor. PF13 has been reassigned to the COMBINE command to combine the line 
pointed to by the cursor with the next line; the resultant lines are limited to 65 characters. PF7 has 
altered the VPFB command so that the work area is emptied before the insertion is performed. 
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USING VISUAL MODE WITH THE DEC VT100 TERMINAL 

The procedures for using visual mode with DEC VT100 terminals is similar to those for using the 
Apple Macintosh terminal. The keyboard layout for the DEC VT100 is as follows: 



ON UNI IIH-Ai hBU!OC*tl) (1 I? U I* 

OOOOOOO 

St I UlAW*ll UNI Situ' l(X.[ill FHANSMH Rtttiul H> t 1} 

cua« i *t t*>«, iim*i * » i u jtWto Win Luumm» hish 



imiiiiMi 



w 



U I 



! ! 



B N 





,., 


P*t 


WJ 


M4 


7 


8 


9 


- 


4 


S 


6 


'» 


1 


2 


3 


INK II 


O 





The DEC VT100 Keyboard 

The basic movement of the cursor is controlled by pressing the the CURSOR-RIGHT, 
CURSOR-LEFT, CURSOR-UP, and CURSOR-DOWN keys (labelled with arrows). The movement of 
the cursor may also be controlled by other keys as listed in the table below. 



VTlOOKey 

CTRL-H or Backsp 

CTRL-M or Return 

CTRL-IorTab 

CTRL-B 

CTRL-K 

CTRL-N 

CTRL-Z 

CTRL-T 

CTRL-V 



Effect 

Move cursor to previous character 

Move cursor to beginning of next line 

Move cursor to next tab position 

Move cursor to beginning of line or beginning of previous line 

Move cursor to beginning of previous line 

Move cursor to last column of line 

Move cursor to end of line or end of next line 

Move cursor to upper left corner 

Move cursor to work field 



The following keys on the DEC VT100 have special functions in visual mode. The actions of these 
keys are controlled only by the terminal routines and not by the editor program itself. 
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VT 100 Key 

CTRL-A 

CTRL-D 

CTRL-W 

CTRL-X 

CTRL-G 

CTRL-L 

CTRL-R 



Effect 

Enter or exit insertion mode (toggle switch) 

Delete the character at the cursor 

Delete the word at the cursor 

Delete all characters to the right of the cursor 

Discard current line changes 

Discard current screen changes 

Rewrite the screen (with changes) 



The VT-100 control program assigns VT100 program functions (PFs) to several of the keys, 
primarily on the numeric pad keyboard. These are named PFO through PF17. These in turn are 
assigned to editor program functions VPF through VPF 17. The default key assignments for the 
VT100 terminal are as follows: 



VPF 


VT 100 Key 


VT100PF 


Default Assignment 


-2 


CTRL-C 


_ 


VEXITED_WORK 


-1 


CTRL-E 


- 


VEXIT 





Numpad 


PFO 


VUPDATE 


1 


Numpad 1 


PF1 


LINE *VT COUNT=-10 


2 


Numpad 2 


PF2 


VPFB 


3 


Numpad 3 


PF3 


VMEMORY 1 


4 


Numpad 4 


PF4 


LINE*VTCOUNT=10 


5 


Numpad 5 


PF5 


VPFE 


6 


Numpad 6 


PF6 


VMEMORY 2 


7 


Numpad 7 


PF7 


LINE*VTCOUNT=l 


8 


Numpad 8 


PF8 


VEXECUTE 


9 


Numpad 9 


PF9 


VMEMORY 3 


10 


Numpad PF1 


PF10 


VINSERT 1 2 


11 


Numpad PF2 


PF11 


VEXTEND 


12 


Numpad PF3 


PF12 


VPREVIOUS 


13 


Numpad PF4 


PF13 


LINE *VT COUNT=-10 


14 


Numpad - 


PF14 


VPFB 


15 


Numpad , 


PF15 


VMEMORY 1 


16 


Numpad ENTER 


PF16 


LINE*VTCOUNT=10 


17 


Numpad . 


PF17 


VPFE 



Note that the default assignments for editor visual program functions (VPFs) 1 through 5 are the same 
as for 13 through 17. 
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USING VISUAL MODE WITH THE IBM 3278 TERMINAL 

The keyboard layout for the IBM 3278 terminal is as follows: 





@@@@Q@e@00@e 




v_> 




m 







j cffi 



The IBM 3278 Keyboard 

The movement of the cursor is controlled by the CURSOR-RIGHT, CURSOR-LEFT, CURSOR-UP, 
and CURSOR-DOWN keys. These keys are labelled with arrows. Movement of the cursor is also 
controlled by the TAB, BACKTAB, and RETURN keys. 

The following keys on the IBM 3278 have special functions in visual mode. The actions of these 
keys are controlled only by the terminal routines and not by the editor program itself. 



3278 Key 

Insert Ca) 
RESET 
Delete (a) 
ERASE EOF 
CLEAR 



Effect 

Enter insertion mode 

Exit insertion mode 

Delete the character at the cursor 

Delete all characters to the right of the cursor 

Discard all current screen changes 



Across the top and to the right side of the keyboard are the program-function pads. These keys are 
labelled PF1 through PF12 and PF13 through PF24. The PF1 through PF12 keys must be pressed in 
conjunction with the ALT key. Each program-function key executes aprogram function. 

Normally (when not in visual mode), the program functions are denned as IBM 3278 device 
commands. In visual mode, each of the programs function is assigned to an editor visual program 
function (VPF) for visual-mode editing. These visual program functions in turn are defined as 
visual-mode commands. The default key assignments for the IBM 3278 terminal are as follows: 
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VPF 



3278 Key 



Default Assignment 

VCURSORWORK 

VEXIT ED_WORK 

VEXIT 

VUPDATE 

LINE *VT COUNT=-10 

VPFB 

VMEMORY 1 

LINE*VTCOUNT=10 

VPFE 

VMEMORY 2 

LINE*VTCOUNT=l 

VEXECUTE 

VMEMORY 3 

VINSERT 1 2 

VEXTEND 

VPREVIOUS 

LINE *VT COUNT=-10 

VPFB 

VMEMORY 1 

LINE*VTCOUNT=10 

VPFE 

VMEMORY 2 

LINE*VTCOUNT=l 

VEXECUTE 

VMEMORY 3 

VINSERT 1 2 

VEXTEND 

VPREVIOUS 

Note that the default assignments for editor visual program functions (VPFs) 1 through 12 are the 
same as for 13 through 24. The editor VPFs may be redefined by using the editor VPF command. 



-3 


SYS REQ 


-2 


PA2 


-1 


PA1 





ENTER 


1 


PF1 


2 


PF2 


3 


PF3 


4 


PF4 


5 


PF5 


6 


PF6 


7 


PF7 


8 


PF8 


9 


PF9 


10 


PF10 


11 


PF11 


12 


PF12 


13 


PF13 


14 


PF14 


15 


PF15 


16 


PF16 


17 


PF17 


18 


PF18 


19 


PF19 


20 


PF20 


21 


PF21 


22 


PF22 


23 


PF23 


24 


PF24 
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SETTING THE VISUAL-MODE RULER 



Normally, each time the visual-screen is displayed, the last line of the screen shows the current 
contents of the predefined variable ED_VRULER. By default, this ruler contains column markers 
that may be used for aligning text on the screen. 

The predefined variable ED_STATUS contains a string expression that is evaluated each time the 
visual-mode screen is displayed. The initial value is copied from the read-only predefined variable 
ED_STATUS_DEF. The string result of this evaluation is displayed in the screen position normally 
occupied by the visual-mode ruler (ED_VRULER) provided that this ruler has been set to the null 
string by the edit command 

LETED_VRULER=" 

When non-null, the visual-mode ruler takes precedence over the contents of ED_STATUS. The 
contents of ED_STATUS may be tailored to fit the user's needs; however, the righthand assignment to 
ED_STATUS must be a string in order to prevent evaluation before the assignment; for example, 

LET ED_STATUS=' "Cursor at line: " ED_CURSOR_LINE ■ 

The default visual-mode ruler may be restored by giving the edit command 
LET ED VRULER=ED VRULER DEF 
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VISUAL-MODE COMMANDS 

Several special visual-mode commands are available to video-screen terminal users while editing in 
visual mode. These commands perform such functions as rapidly moving the cursor on the screen, 
executing commands from the work field, extending screen lines, inserting new screen lines, and 
splitting lines into shorter segments. 

The visual-mode commands normally are executed either 

(1) from the work field by depressing an appropriately assigned program-function key (see 
below), or 

(2) by depressing a program-function key that has been assigned as a visual-mode command. 

Executing Commands from the Work Field 

A visual-mode command may be executed from the work field by inserting the command into the 
work field and then executing the VEXECUTE visual mode command. By default, this command is 
assigned to editor visual program functions VPF 8 and VPF 20. 

For example with the Ontel terminal, the VSPLIT command may be used to split a line into two 
shorter lines. First, the cursor must be moved to the work field, either manually by moving the cursor 
with the cursor-positioning keys or directly by depressing the SHIFT-HOME key. After the VSPLIT 
command has been entered into the work field, the cursor is moved to the line to be split and positioned 
at the column where the split is to be made. Finally, either the CTRL-8 or PF8 key is pressed. 

Executing Commands via Program-Function Keys 

Many terminals have a set of program-function and control keys that are specially configured for use 
in visual mode. Details on using these program-function keys are given with the individual terminal 
descriptions above. 

Visual-Mode Command Summary 

The following commands affect the operation of the editor in visual mode. The same notation is 
used for the visual-mode commands as is used for the edit command definitions. 

VCURSOR LINE [linenumber [{col I ZIP}]] 

VCURSOR WORK [{col I ZIP}] 

VCURSOR HOME 

VCURSOR COST 

VEXE CUTE 

VEXI T [strexp] 

VEX TEND [n] 

VINSERT [init] [mult] 

VMA RK [{RESET I FIRST}] 

VMEMORY [n] 

VPF {SAVE I RESTORE} pfname 

VPF {n I ATTN I RETURN} =command 

VPFB 

VPFE 
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VPREVIOUS 
VSPLIT 
VTEST 
VUPDATE 
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Purpose: 
Prototype: 



Action: 



Conditions: 
Example: 



VCURSOR 
Visual Edit Command Description 

To set the position of the visual-mode cursor. 

(a) VCURSOR LINE [linenumber [{col I ZIP}]] 

(b) VCURSOR WORK [{col I ZIP}] 

(c) VCURSOR HOME 

(d) VCURSOR COST 

where 

"linenumber" is the line number of the line the cursor is to appear in. 

"col" is the column number within the line or work area the cursor is to 
appear in. The first character of a line is column 1 . 

If prototype (a) is specified, the cursor is placed on the line with line number 
"linenumber". The cursor is placed either at the column given by "col" or after 
the last character in the line, if ZIP is given. If neither "col" nor ZIP is specified, 
the cursor is placed at the beginning of the line. The line number is defaulted 
to the current line (*), if omitted. If the specified line does not exist, the cursor 
is placed on the next previous line to the specified line, if it appears on the 
screen; otherwise, the cursor is placed in the home position at the top of the 
screen. 

If prototype (b) is specified, the cursor is placed in the work area. The cursor is 
placed either at the column given by "col" or after the last character in the line, if 
ZIP is given. If neither "col" nor ZIP is specified, the cursor is placed at the 
beginning of the line. 

If prototype (c) is specified, the cursor is placed in the home position, which is the 
first column of data of the first line of the screen (the top line). 

If prototype (d) is specified, the cursor is positioned at the beginning of the cost 
field. 

SUCCESS if no error messages are generated. 

VCURSOR LINE 312.2 19 

The above example positions the cursor to line 312.2 at data column 19. 
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VEXECUTE 
Visual Edit Command Description 



Purpose: 

Prototype: 

Action: 



Conditions: 



To execute the contents of the work area as an edit command. 

VEXE CUTE 

The VEXECUTE command executes the contents of the work area as an edit 
command. By default, the execution of the command is not verified in the 
conversation buffer unless the @VMV modifier is appended to the command or 
the editor VMV option is ON. 

If the command is not a valid edit command, an error message is printed in the 
ruler area. 

The default settings of VPF 8 and VPF 20 execute the VEXECUTE command. 

When VEXECUTE is used in an edit procedure, the execution of the work area is 
delayed until all of the commands of the procedure have been executed so that 
edit-command messages such as "Search failed" and "File does not exist" may be 
printed (these messages are suppressed when they occur within the procedure). 
The EXECUTE ED_WORK command may be used in an edit procedure to 
execute the work area immediately. 

SUCCESS if no error messages are generated. 
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VEXIT 
Visual Edit Command Description 



Purpose: 
Prototype: 



Action: 



Conditions: 
Example: 



To exit visual mode and optionally print a string expression on the terminal 
screen (conversation buffer). 

VEXI T [strexp] 

where 

"strexp" is an editor string expression which is to be printed on the 
terminal screen after exiting visual mode. The string expression may 
contain or consist solely of an editor variable, in which case the contents of 
the variable is inserted into the string. 

The string expression specified by "strexp" is evaluated and printed in the 
terminal conversation buffer and visual mode is exited. By printing the string 
in the conversation buffer, it will appear on the screen after visual mode is 
exited. 

If "strexp" is omitted, visual mode is exited without printing a string in the 
conversation buffer. 

The default setting for VPF -2 is the command VEXIT ED_WORK, where 
ED_WORK is an editor variable containing the current contents of the work 
area. 

The file buffers in memory are written to disk. This is the same as if the 
CLOSE command were executed. 

SUCCESS if no error messages are generated. 
VEXIT 'Finished with source update' 

Visual mode is exited and the string "Finished with source update" is 
printed on the user's terminal. 
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VEXTEND 
Visual Edit Command Description 



Purpose: 

Prototype: 

Action: 



Conditions: 



To extend the line containing the cursor or the work area by one screen line. 

VEX TEND [n] 

If the cursor is on a line on the screen, the line is extended with null characters 
into the next "n" screen lines. If the cursor is in the work area, the work area is 
extended by an additional screen line of nulls. Note that if there is already an 
additional screen line of nulls allotted to the line the cursor is on, this command 
has no effect unless a window has been set which causes parts of lines not to be 
wrapped. 

The VEXTEND command toggles between wrapping and not wrapping a line 
which extends beyond the view of the window. When VEXTEND is first 
executed, an extension of the line will appear and the line remains unwrapped. 
If the user types in the extension area, the data will be inserted at those column 
ranges and any hidden data in the line (which cannot be seen due to the window) 
will follow the newly inserted data. Executing a second VEXTEND command 
will cause the line to wrap so that data may be appended to the line. 

The line may be further extended after one or more nonnull characters 
(including blanks) are inserted into the first extension by again issuing the 
VEXTEND command. 

A line that has been extended by the VEXTEND command will remain extended 
until one of the following conditions occurs: 

(1) A VUPDATE command is executed (the default for the ENTER key). 

(2) A VEXIT command is executed. 

(3) A VEXTEND command is executed on a different line. 

(4) An EDIT, RENUMBER, or SPREAD command is executed. 

The default settings of VPF 11 and VPF 23 execute the VEXTEND command. 
SUCCESS if no error messages are generated. 
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VINSERT 
Visual Edit Command Description 



Purpose: 
Prototype: 



Action: 



Modifiers: 



Conditions: 



To insert null lines on the screen after the line containing the cursor. 

VINSERT [init] [mult] 

where 

"init" is the number of null lines to insert after the current line the first 
time VINSERT is executed. 

"mult" is the multiplier for the number of null lines for subsequent 
executions of VINSERT. 

If VINSERT is executed and the cursor is not on a null line, "init" null lines are 
inserted after the line containing the cursor, and the cursor is placed at the first 
character of the first null line. These null lines have a "." in the line-number 
field instead of the line number, so that they can be differentiated from lines 
that are entirely blank. If VINSERT was previously executed and the cursor is 
already on a null line, the null lines remaining on the screen (call their number 
"n") are replaced by ("n" * "mult") null lines. For example, suppose that VPF 22 
is assigned VINSERT 3 4. Then if VPF 22 is executed, three null lines will 
appear on the screen. Then if the first null line is filled with text and VPF 22 is 
again executed, the remaining two null lines will be replaced by eight null lines 
(2*4). 

"init" defaults to 1 and "mult" defaults to 2. 

Null lines added with the VINSERT command will continue to be displayed 
until one of the following conditions occurs: 

(1) A VUPDATE command is executed. 

(2) A VEXIT command is executed. 

(3) A VINSERT command is executed with the cursor outside the 
current insertion area. 

(4) An EDIT or SPREAD command is executed. 

The default settings of VPF 10 and VPF 22 execute the command VINSERT 1 2. 

@OPL If @OPL is specified, the insertion space will disappear when any 
program-function key is pressed. The default is @NOPL. 

@PLN If @PLN is specified, the inserted null lines will be prefixed with their 
line numbers. The default is @NPLN. 

SUCCESS if no error messages are generated. 
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Example: vinsert 4 3 



The first time this command is executed, 4 null lines are added after the 
line containing the cursor. If it is executed again without moving the 
cursor (or adding data to the null line), 12 null lines will appear after the 
line containing the cursor; if it is executed again, 36 null lines will appear, 
and so on. 
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VMARK 
Visual Edit Command Description 



Purpose: 

Prototype: 

Action: 



Conditions: 



To define a region in visual mode. 

VMA RK [{RESET I FIRST}] 

The first time VMARK is executed, the line containing the cursor will be marked 
with an "F" in the first column to indicate the first line in the VMARK region. 
The next time VMARK is executed, the line containing the cursor will be 
marked with an "L" to indicate that last line in the region. 

The marked lines delineate a region with the name /VMARK which can be used 
as an editor region. 

There can be only one VMARK region defined at a time. Before defining a new 
VMARK region, the VMARK RESET command must be given to clear the 
previous region. 

The VMARK FIRST command is equivalent to issuing the sequence VMARK 
RESET, VMARK. 

None 
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VMEMORY 
Visual Edit Command Description 

To "remember" a file position for subsequent restoration. 

VMEMORY [n] 

where 

"n" is an integer from 1 to 6 specifying the memory position. 

The VMEMORY command "remembers" a file position so that it may be 
subsequently restored. 

There are six memory positions available, numbered 1 through 6. The initial 
definitions of the memory positions are as follows: 



Position 1 
Position 2 
Position 3 
Position 4 
Position 5 
Position 6 



The first line of the file (*F) 

Line 1000 

The last line of the file (*L) 

Line 1500 

Line 2000 

Line 3000 



A memory position may be reset by issuing the VMEMORY command twice in 
succession without any intervening commands or movement of the cursor. To 
return to a "remembered" position, the VMEMORY command is issued once. 
For example, the command sequence 



VMEMORY 1 
VMEMORY 1 

will set memory position 1 to the current position on the screen. Subsequently 
issuing the command 

VMEMORY 1 

will return the screen to the position "remembered" when the two VMEMORY 
commands were issued. 

If the VMEMORY command is given without a memory-position number, the 
previous file position is restored. This is the same as the VPREVIOUS 
command (see the VPREVIOUS command description). 

The default settings of several editor VPFs also perform the same function. 
They are 
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VPFs 3 and 15: 
VPFs 6 and 18: 
VPFs 9 and 21: 
VPFs 12 and 24: 



VMEMORY 1 
VMEMORY2 
VMEMORY 3 
VMEMORY (same as VPREVIOUS) 



Conditions: 



SUCCESS if no error messages are generated. 
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VPF 
Visual Edit Command Description 



Purpose: 
Prototype: 



Action: 



Conditions: 



To save or restore the settings of the editor visual program functions as a 
cluster, or to assign an edit command to an editor visual program function. 

(a) VPF SAVE pfname 

(b) VPF RESTORE pfname 

(c)VPF{n I ATTN I RETURN}=command 

where 

"pfname" is the name for the program-function cluster (1 to 7 characters). 

"n" is an editor visual program-function number. 

"command" is an edit command to be assigned to the editor visual program 
function. The command starts immediately after the "=" sign. 

If prototype (a) is specified, the current settings of the editor visual program 
functions are saved as a cluster named "pfname". The current settings of the 
visual program functions remain the same. A saved program-function cluster 
may be restored using prototype (b). 

If prototype (c) is specified, an edit command is assigned to the editor visual 
program function "n", or to the ATTN or RETURN keys. The number of visual 
program functions is dependent on the type of terminal being used (see the 
individual terminal descriptions for visual mode earlier). The default editor 
visual program-function assignments are given below. 

The default editor visual program-function definitions are always available in 
the cluster DEFAULT and may be restored using prototype (b), e.g., VPF 
RESTORE DEFAULT. 

SUCCESS for prototypes (a) and (b) if the cluster is saved or restored; 
SUCCESS for prototype (c) if the specified key is set. 



VPF Visual Edit Command 151 



MTS 18: The MTS File Editor 




February 1988 




Visual 




Prog. Func. 


Default Assignment 


-1 


VEXIT 


-2 


VEXIT ED_WORK 


-3 


VCURSORWORK 





VUPDATE 


1 


LINE *VT COUNT=-10 


2 


VPFB 


3 


VMEMORY 1 


4 


LINE*VTCOUNT=10 


5 


VPFE 


6 


VMEMORY 2 


7 


LINE*VTCOUNT=l 


8 


VEXECUTE 


9 


VMEMORY 3 


10 


VINSERT 1 2 


11 


VEXTEND 
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VPFB 
Visual Edit Command Description 



Purpose: 

Prototype: 
Action: 



Conditions: 



To append the remainder of the line containing the cursor to the end of the work 
area. 

VPFB 

The VPFB command appends the remainder of the line containing the cursor to 
the end of the work area. The remainder of the line starts at the cursor 
position. 

If the cursor is in the work area, this command has no effect. 

The default settings of VPF 2 and VPF 14 execute the VPFB command. 

SUCCESS if no error messages are generated. 
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VPFE 
Visual Edit Command Description 



Purpose: 

Prototype: 
Action: 



Conditions: 



To insert the contents of the work area before the character in a line that 
contains the cursor. 

VPFE 

The VPFE command inserts the contents of the work area into the line that 
contains the cursor. The insertion is made at the position pointed to by the 
cursor so that the characters before the cursor compose the start of the line, the 
work area composes the middle of the line, and the characters from the cursor 
onward compose the end of the line. 

If the cursor is in the work area, this command has no effect. 

The default settings of VPF 5 and VPF 17 execute the VPFE command. 

SUCCESS if no error messages are generated. 
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VPREVIOUS 
Visual Edit Command Description 



Purpose: 

Prototype: 

Action: 



Conditions: 



To move the screen to the "previous" file position. 

VPREVIOUS 

The VPREVIOUS command moves the screen to the "previous" file position, 
which is either 

(1) the file position before the last VMEMORY command was issued, 

(2) the file position before the line number in the visual-mode command 
field was set, 

(3) the file position when visual mode was last exited, or 

(4) the file position before an edit command was executed via the 
VEXECUTE command or the character "C" in the cost field. 

The default settings of VPF 12 and VPF 24 execute the VPREVIOUS command. 

SUCCESS if no error messages are generated. 
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VSPLIT 
Visual Edit Command Description 



Purpose: 

Prototype: 

Action: 



Conditions: 



To split a line starting at the character the cursor is on. 

VSPLIT 

The VSPLIT command splits the line containing the cursor into two lines. The 
split is made so that the characters before the cursor remain in the current line, 
and a new line is inserted after the current line. The new line consists of the 
characters starting at the cursor through the end of the line. 

SUCCESS if no error messages are generated. 
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Purpose: 

Prototype: 

Action: 

Modifiers: 

Conditions: 

Example: 



VTEST 
Edit Command Description 

To test if the editor is currently executing in visual mode. 

VTEST 

The execution of this command will set the condition to SUCCESS if the editor is 
currently executing in visual mode; otherwise, the condition is set to FAILURE. 

None. 

SUCCESS if in visual mode; FAILURE otherwise. 

PROCEDURE !SET_WINDOW 

VTEST 

GOTO END ON FAILURE 

WINDOW LEFT 

END 

In the above example, the procedure uses the VTEST command to 
determine whether a window is to be set on the file. If the editor is in 
visual mode, a window will be set to be the size of the display screen. This 
has the effect of causing lines longer than the width of the screen to be 
extended to the right of the screen instead of being wrapped. In line 
mode, the window setting will not be changed. 
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VUPDATE 
Visual Edit Command Description 



Purpose: 

Prototype: 
Action: 



Conditions: 



To update the contents of the edit file in accordance with the changes made to 
the visual-mode screen. 

VUPDATE 

The VUPDATE command updates the contents of the edit file in accordance 
with the changes made to the visual-mode screen. The screen is then rewritten 
using the updated contents of the edit file. The file buffers in memory are 
written to disk. This is the same as if the CLOSE command were executed. 

The default setting of VPF executes the VUPDATE command. 

SUCCESS if no error messages are generated. 
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PATTERN MATCHING 



The pattern-matching facility of the editor allows the user to perform more sophisticated operations 
on a file than mere string searching or replacement. The pattern-matching facility is based on the 
algorithms for pattern matching that are used by the SNOBOL4 programming language. Currently, 
pattern matching may be done by the ALTER, CHANGE, MATCH, and SCAN commands. The 
PATTERNS option must be set to ON to enable the pattern-matching facility, e.g., 

SET PATTERNS=ON 

In simple terms, pattern matching is the process of examining a subject for a substring or set of 
substrings specified by a pattern structure. The subject is a line or set of lines in the file being edited. 
The pattern structure is a set of substrings against which the subject is to be examined; each substring 
in the pattern is called a pattern element. For example, if the first line (line 1) of the file contains the 
line 

THIS IS THE FIRST LINE OF MY FILE. 

the command 

SCAN 1 "FIRST" 

will examine the first line for the string "FIRST". In this case, the subject is line 1 of the file and the 
pattern is composed of a single element, the string "FIRST". If the line contains the string, the pattern 
match is successful. If the line does not contain the string, the match fails. The above pattern match 
succeeds since the string "FIRST" is contained in the first line of the file. However, if the command 

SCAN 1 "SECOND" 

were executed, the pattern match would fail since the line does not contain the string "SECOND". The 
above two patterns are each composed of a single element, i.e., a simple string. 

The concatenation and alternation operators may be used to construct more complicated patterns 
composed of several elements. The concatenation operator is indicated by a blank between pattern 
elements. Concatenation is used to combine several pattern elements into an ordered sequence that is 
to be scanned for in the subject. These pattern elements must occur in immediate succession within 
the subject. For example, the command 

SCAN 1 "FIRST" " LINE" 

would scan the line for the string "FIRST" followed immediately by the string " LINE"; in this case, the 
pattern match again succeeds. However, if the command 

SCAN 1 "FIRST" "FILE" 

were executed, the pattern match would fail since the subject does not contain the string "FIRST" 
followed immediately by the string "FILE". 

The alternation operator is indicated by a vertical bar ( I ) or an exclamation point (!) between 
pattern elements. Alternation is used to indicate that one of several pattern elements is to be matched 
in the subject. For example, the command 
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SCAN 1 "FIRST" | "SECOND" 

would scan the line for the string "FIRST" or the string "SECOND"; in this case the pattern match 
again would succeed. When a series of pattern elements is used as an alternative via the alternation 
operator, the entire set of alternatives is treated as a single pattern element; if one of the alternatives 
succeeds, the entire set is successful. 

Concatenation and alternation may be used together to build more complex patterns. Since 
concatenation has higher precedence than alternation, parentheses may be used to control the 
structure of the pattern. For example, the command 

SCAN 1 "FIRST" " LINE" | "SECOND" " LINE" 

may be used to scan the subject for the string "FIRST LINE" or "SECOND LINE". This command may 
also be written as 

SCAN 1 ("FIRST" | "SECOND") " LINE" 

In this case, the parentheses are needed to override the higher precedence of the concatenation 
operator. 

The editor uses a pattern-matching scanner for matching the subject string against the pattern 
structure. The pattern structure is used like a small program or procedure that instructs the scanner 
how to examine the subject. At any instant during scanning, the scanner uses two pieces of 
information: 

(1) where in the subject string it should be looking, and 

(2) what element of the pattern structure it should be matching. 

The scanner maintains a pointer called a cursor, which is positioned at the character in the subject that 
the scanner is trying to match against an element in the pattern structure. 

When scanning commences, the cursor is positioned at the first character in the subject. The 
scanner then attempts to match the subject against the first element of the pattern. 

(1) If the match is successful, the cursor is moved past the characters that matched the 
pattern element and is positioned at the character that must match the next element in 
the pattern structure, and the process is repeated. When all elements in the pattern 
structure have been successfully matched, the pattern match succeeds. 

(2) If the match against the pattern element was not successful, the scanner backs up and 
attempts to match any alternatives to previous elements in the pattern structure, if they 
exist. If any of the alternatives provides a successful match, the cursor is moved past the 
matched characters and is positioned at the character that must match the next element 
in the pattern structure, and the pattern-match process continues as above. If none of 
the alternatives provides a successful match, the pattern match fails. 

Each pattern element in the pattern must be matched against the subject in order for the pattern 
match to be successful. In addition, the matched pattern elements must occur in immediate 
succession within the subject. 
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As pattern matching proceeds, the cursor is moved from left to right along the subject string until 
the entire pattern match is successful (all elements of the pattern structure are matched against the 
subject string) or until the cursor reaches the end of the subject string without finding any possible 
successful matches. In the latter case, the entire pattern match fails although there may be successful 
matches by individual elements in the pattern. 

The pattern-matching algorithm is more graphically illustrated by considering what happens when 
the pattern structure 

(iipii | ii M ii) (n A n | "AT") ("CH" | "CHING") 

is used to match the subject string "MATCHING". Initially, the cursor is positioned at the "M" in the 
subject string 

I 

MATCHING 

and a match is attempted against the first element "P" of the pattern. Since this match is 
unsuccessful, a match is tried against the alternative "M" to the first element, which does produce a 
successful match. The cursor is then positioned past the matched character "M" to the next character 
"A" in the subject 

I 

MATCHING 

and a match is attempted against the second element of the pattern structure "A". This also produces 
a successful match, and the cursor is positioned to the next character "T" in the subject 

I 

MATCHING 

and a match is attempted against the third element in the pattern. However, since the third element 
"CH" or its alternative "CHING" does not produce a successful match, the scanner backs up in the 
pattern in order to try alternatives to previously matched pattern elements to determine if they will 
produce successful matches. In this case, the alternative "AT" to the second element "A" also produces 
a successful match and the cursor is positioned past the "AT" in the subject to "C", 

I 

MATCHING 

which does produce a successful match in the third pattern element. At this point, the entire pattern 
has successfully matched the string "MATCH" and the pattern match succeeds. The elements of the 
pattern that produced the match were "M", "AT", and "CH". Notice that the alternative to the third 
element "CHING" was not used during the match since the entire pattern match succeeded before that 
alternative was attempted. 

The above example also illustrates an important control that the user has over the scanner. In a 
pattern structure, alternatives are matched by the scanner in left-to-right order. Therefore, by 
positioning alternatives correctly, the user can control the order in which the scanner matches them. 

Anchoring is another concept that is important in pattern matching. Both the SCAN command 
and the MATCH command may be used for scanning the subject string for a pattern. The only 
difference between the SCAN command and the MATCH command is that the SCAN command allows 
the pattern to be matched anywhere in the subject while the MATCH command requires that the 
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pattern match the subject string beginning at the first character position of the current column range. 
For example, 

SCAN 1 "FIRST" 

successfully matches the string "FIRST" in the above subject string, while the command 

MATCH 1 "FIRST" 

fails to match the subject since the string "FIRST" is not at the beginning of the subject. 

Predefined Pattern Elements 

The editor pattern-matching facility has several special predefined pattern elements which may be 
used in pattern structures. Most of these special elements are designed to match a certain group of 
character strings instead of a specified character string. Some of the most commonly used pattern 
elements are described below; the complete descriptions of all the pattern elements are given at the end 
of this volume. The previous line containing the string 

THIS IS THE FIRST LINE OF MY FILE. 

should be used as the subject in the following examples. 

(1) LEN 

LEN is a pattern element that may be used to match a character string of a specified 
length within the subject. The command 

SCAN 1 LEN (4) 

will match the first four characters of the first line which is the string "THIS". The last 
word in the line could be matched by the command 

SCAN 1 LEN (4) " . " 

In this case, the pattern instructs the scanner to match a string of four characters which 
is immediately followed by the character ".". 

(2) SPAN, BREAK, SKIP 

SPAN and BREAK are pattern elements that are used to match a run of characters. 
Patterns used to match 

(a) a run of blanks, 

(b) a run of digits , or 

(c) a run of letters (a word) 

may be formed by using 

(a) SPANC '*) 

(b) SPANO'0123456789") 

(c) SPANC ABCDEFGHIJKLMNOPQRSTUVWXYZ") 
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The pattern element SPAN matches the longest string in the subject starting at the 
current cursor position that consists solely of the characters appearing in the argument 
for SPAN. For example, the command 

SCAN 1 SPANCABCDEFGHIJKLMNOPQRSTUVWXYZ") 

will match the first word "THIS" of the subject. The SPAN pattern element must match 
at least one character in the subject, or else it fails. 

Patterns used to match 

(a) everything up to the next blank, 

(b) everything up to the next punctuation mark, or 

(c) everything up to the next number 

may be formed by using 

(a) BREAK(" ") 

(b) BREAKC*,.;:!?") 

(c) BREAKC+-0123456789") 

The pattern element BREAK matches the longest string in the subject starting at the 
current cursor position that does not contain a character from the argument. In other 
words, BREAK matches everything up to but not including the first "break" character. 
For example, the command 

SCAN 1 BREAK(" ") 

also will match the first word "THIS" of the subject. The BREAK pattern element must 
find at least one break character in the subject, or else it fails. 

The SKIP pattern element is similar to SPAN except that it does not require that any 
characters be matched from the subject. 

The following example illustrates how the SPAN and BREAK pattern elements may be 
used to decompose the beginning of a sentence into its individual words. 

SCAN 1 BREAK(" ") SPANC ") BREAKC " ) 

In this case, the first occurrence of BREAK in the pattern matches the word "THIS", and 
the second BREAK matches the word "IS"; the SPAN pattern element matches all of the 
blanks that occur between the first two words. 

(3) ANY, NOTANY 

ANY and NOTANY are pattern elements that are used to match single characters. ANY 
matches any character appearing in its argument. For example, the command 

SCAN 1 ANYCAEIOU") 

will match the first vowel that appears in the subject, in this case the letter I in the first 
word "THIS". NOTANY matches any character that does not appear in its argument; for 
example, the command 



Pattern Matching 163 



MTS 18: The MTS File Editor 
February 1988 

SCAN 1 NOTANYC'AEIOU") 

will match the first character that is not a vowel, in this case the letter "T". 

(4) TAB, RTAB, REM 

TAB and RTAB are pattern elements that are used to match all characters from the 
current cursor position up to a specified column in the subject. TAB(n) matches up 
through the nth character in the subject; RTAB(n) matches up to but not including the 
nth character from the right end of the subject. For example, the TAB pattern element 
in the command 

SCAN 1 BREAK (" ") TAB (11) 

will match the string " IS THE", while the RTAB pattern element in the command 

SCAN 1 "LINE" RTAB(l) 

will match the string " OF MY FILE". The pattern element RTAB(O) is useful for 
matching the remainder of the subject; this pattern element also may be written as REM. 
For example, REM in the command 

SCAN 1 "LINE" REM 

will match the string " OF MY FILE.". 

(5) POS, RPOS 

POS and RPOS are pattern elements that are used to check whether the cursor is at a 
certain character position in the subject. POS(n) succeeds only if the cursor is positioned 
immediately past the nth character; RPOS(n) succeeds if the cursor is positioned 
immediately before the nth character from the right end of the subject. Both POS and 
RPOS match the null string, i.e., they do not match any of the actual characters in the 
subject. For example, the POS pattern element in the command 

SCAN 1 BREAK (" ") POS (4) 

will check to ensure that the cursor is just past the fourth character in the subject, i.e., 
that the first word of the sentence is a four-character word. The pattern elements 
POS(O) and RPOS(O) are particularly useful for checking if the cursor is at the beginning 
or end of the subject. For example, the command 

SCAN 1 POS(O) "THIS" 

succeeds only because the word "THIS" is the first word in the subject, while the command 

SCAN 1 "LINE" RPOS(O) 

fails because the word "LINE" is not the last word of the subject. The use of POS(O) or 
RPOS(O) in effect anchors the scanning to the left or right end of the subject. The 
MATCH command also may be used to anchor the pattern match to the left end of the 
subject, e.g., 

MATCH 1 "THIS" 
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(6) AKB 



ARB is a pattern element that matches zero or more arbitrary characters. When first 
encountered by the scanner moving from left to right, ARB matches the null string. 
When backed into on subsequent scans, ARB increases the number of characters matched 
by one. ARB fails only when it no longer can increase the number of characters matched. 
For example, the ARB pattern element in the command 

SCAN 1 BREAK (" ") ARB SPAN ( "ABCDEFGHI JKLMNOPQRSTUVWXYZ" ) "." 

will match everything between the first and last words of the sentence in the subject. In 
this case, the match of ARB is increased one character at a time starting with the first 
character after the word "THIS" until the pattern element SPAN matches a sequence of 
letters followed by a period at the end of the sentence. In effect, the ARB pattern 
element moves the cursor across the remainder of the subject from the current cursor 
position until the rest of the pattern succeeds (or until the end of the subject is 
encountered). 

Variables 

The editor allows the user to define variables for use in the construction of pattern structures. 
These variables may be used by the pattern structure to assign matched substrings of the subject, or 
may be used to save complete pattern structures. 

A variable is initially created by the LET command, which has the syntax 

LET variable=value 

The variable name consists of 1 to 255 characters, the first of which must be alphabetic (A-Z) with the 
subsequent ones being alphanumeric (A-Z, 0-9, and _). The value may be any one of the following 
types: 

(1) an integer, e.g., 5, -4. 

(2) a line number, e.g., *F, 1.5 

(3) a string or string expression (see below) 

(4) a pattern (see below). 

A variable is not declared to be of a single data type; the context in which the variable is used 
determines its data type. 

If the value of the variable is a string, the string must be enclosed by editor string delimiters, e.g., 
"STRING1", 'string2'. The null string, which is a string of zero characters, also may be assigned to a 
variable by giving adjacent string delimiters, e.g., "" or ". A string expression, which is the 
combination of one or more strings and variables whose values are strings, may be the value of a 
variable. Each string and/or variable in the expression must be separated by one or more blanks. 
The value is the concatenation of the values of the individual components taken from left to right. For 
example, if X="ABC" and Y="123", then 

LET W = X 'DEF' Y ' 45' "6" 



Pattern Matching 165 



MTS 18: The MTS File Editor 
February 1988 

would result in W="ABCDEF123 456". 

The value of a variable may be a pattern structure. For example, the command 

LET PATl = BREAK (" ") SPAN(" " ) BREAK ( " ") 

may be used to assign the above pattern to the variable PATl which then may be used subsequently by 
another editor command, e.g., 

SCAN 1 PATl 

This SCAN command is equivalent to the SCAN command given above for decomposing a sentence into 
its individual words. 

Assigning patterns to variables is very useful for preserving commonly used pattern structures. 
Some common examples are: 

LET ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZ" 

LET LCALPHA = "abcdef ghi jklmnopqrstuvwxyz" 

LET NUM = "0123456789" 

LET ALPHANUM = ALPHA LCALPHA NUM 

LET PUNC = ".,;:!?" 

LET ANYALPHA = ANY (ALPHA) 

LET ANYNUM = ANY (NUM) 

LET SPNALPHANUM = SPAN (ALPHANUM) 

LET BKPUNC = BREAK (PUNC) 

The value, type, and length of a variable may be displayed by issuing the command 
PRINT VAR=variable 

The names of all defined editor variables may be displayed by issuing the command 

PRINT VARS 

Predefined Variables 

The editor has several predefined variables. These are listed below. The variables marked as 
read-only (RO) cannot be directly modified by the user. 

ED_AZ Upper and lowercase letters (RO) 

ED_COUNT Count produced by COUNT command (RO) 

ED_CURSOR_COL Column of cursor in visual mode (RO) 

ED_CURSOR_FIELD Type of line pointed to by cursor (LINE, WORK, or RULER) 

(RO) 

ED_CURSOR_LINE Line number of cursor in visual mode (RO) 

ED_CURSOR_POS POS value (column - 1) of cursor in visual mode (RO) 

ED_DATA_COLS Number of data column positions (RO) 

ED_FILENAME Edit file name (without trailing blanks) (RO) 

ED_LCAZ Lowercase letters (RO) 

ED_LEFT_COLUMN Left value of COLUMN command (RO) 

ED_LEFT_WINDOW Left value of WINDOW command (RO) 

ED_MSINK Writes a string to MSINK 

ED_MSOURCE Reads a line from MSOURCE and returns result as a string 
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ED_PF_NAME 

ED_RIGHT_COLUMN 

ED_RIGHT_WINDOW 

ED_SAVENAME 

ED_SCAN_COL 

ED_SCREEN_LINES 

ED_SINK 

ED_SOURCE 

ED_STATUS 

ED_STATUS_DEF 

ED_TIME 

ED_UCAZ 

ED_VMARK_FIRST_COL 

ED_VMARK_FIRST_LINE 

ED_VMARK_LAST_COL 

ED_VMARK_LAST_LINE 

ED_VRULER 

ED_VRULER_DEF 

ED_WORK 

ED 09 
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(RO) 

PF-key cluster name (RO) 

Right value of COLUMN command (RO) 

Right value of WINDOW command (RO) 

Name associated with the current SAVE/REMEMBER 

commands (RO) 

Column number of last scan match (RO) 

Number of lines on screen (RO) 

Writes a string to SINK 

Reads a line from SOURCE and returns result as a string (RO) 

Status expression for visual mode 

Default status expression for visual mode (file name, column 

values, window values, PF-key cluster name) (RO) 

Current time of day (RO) 

Uppercase letters (RO) 

Column number associated with VMARK first line (RO) 

First line of VMARK region (RO) 

Column number associated with VMARK last line (RO) 

Last line of VMARK region (RO) 

Current visual-mode ruler 

Default visual-mode ruler (RO) 

Contents of visual-mode work area 

Numeric characters (RO) 



As an example, the following SCAN command will place the first complete "word" (string of nonblank 
characters) of the current line into the visual editor work area. 

SCAN * SKIP(" ") (SPAN(ED_AZ ED_09) $ ED_WORK) 

Pattern-Match Value Assignment 

Variables may be assigned values during the pattern-matching process via the $ assignment 
operator. The form of the assignment is 

pattern-element $ variable 

If "pattern-element" is matched during the pattern-matching process, the matched substring will be 
assigned to "variable". This assignment is done immediately. Thus, regardless if the entire pattern 
match subsequently fails, "variable" will be assigned a value if "pattern-element" matches a substring 
of the subject. For example, using the previous line containing the string 

THIS IS THE FIRST LINE OF MY FILE. 

the command 

MATCH 1 BREAK (" ") $ WORD SPAN(" " ) "IS" 

assigns the first word "THIS" to the variable WORD. If the pattern were changed to 

MATCH 1 BREAK (" ") $ WORD SPAN(" " ) "WAS" 

the variable WORD would still be assigned the string "THIS" even though the entire pattern match 
fails. 
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The precedence of the $ operator is higher than that of either the concatenation or alternation 
operators. Parentheses may be used in the pattern to override the precedence. For example, the 
command 

MATCH 1 BREAK (" ") SPAN(" ") BREAK ( " " ) $ WORD 

will assign the string "IS" to the variable WORD, while the command 

MATCH 1 (BREAK (" " ) SPAN(" ") BREAK ( " ")) $ WORD 

will assign the string "THIS IS" to the variable WORD. The above examples use the MATCH 
command to anchor the pattern match to the beginning of the string. Note that the value of the 
variable cannot be used as a pattern element, e.g., 

MATCH 1 BREAK (" ") $WORD SPAN(" ") WORD 

is invalid. 

TAB and REM may be used in conjunction with value assignment when scanning files containing 
structured data such as data that is ordered by column number. For example, if line 10 of a file 
contains 

JON Q. DOUGH 123 DOLLAR ST. BUCKMUCH, TENN. 

the command 

SCAN 10 TAB (20) $ NAME TAB (40) $ ADDR REM $ TOWN 

can be used to break up the subject line into its constituent components, e.g., name, street address, and 
town. In this case, the value assignments would be 

NAME = "JON Q. DOUGH " 

ADDR = "123 DOLLAR ST. " 
TOWN = "BUCKMUCH, TENN. " 

Pattern-Match Replacement 

A matched substring in the subject may be replaced by another string or a string expression via the 
= replacement operator. The form of the replacement is 

(pattern-element = expression) 

If "pattern-element" is successfully matched during the pattern-matching process, the matched string 
is replaced in the subject by "expression". The replacement is done only if the entire pattern match 
succeeds, "expression" may be either a single string or a string expression as defined above under 
"Variables". The string expression may not contain parentheses, "pattern-element" consists of all of 
the pattern elements to the left of the = operator until the beginning of the pattern or an unbalanced 
left parenthesis "(" is encountered. The replacement operator may only be used in patterns with the 
ALTER and CHANGE commands. For example, the command 

ALTER 1 ("FIRST" = "NEXT") 

may be used to alter the first line of the file to 
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THIS IS THE NEXT LINE OF MY FILE. 



"expression" consists of all strings and variables after the = operator until an unbalanced right 
parenthesis ")" is encountered. More than one replacement is allowed in a pattern if the replacements 
do not overlap. For example, the command 

ALTER 1 ("FIRST" = "NEXT") ARB ("FILE" = "DATA") 

may be used to alter the first line to 

THIS IS THE NEXT LINE OF MY DATA. 

In this case, parentheses are needed around both replacement operations in order to exclude the 
substring matched by ARB from the replacements. 

"expression" is evaluated after the pattern match occurs and before the replacement operation is 
done. Therefore, any variables whose values are changed by the $ assignment operator will have their 
new values used in the replacement. For example, the command 

ALTER 1 ("FIRST" = "NEXT") ARB ("FILE" $ WORD = "DATA " WORD) 

may be used to alter the first line to 

THIS IS THE NEXT LINE OF MY DATA FILE. 

In this case, the variable WORD is assigned the value of the matched string "FILE" and then used as 
part of the replacement operation. 

The ALTER and CHANGE commands normally function in unanchored mode, that is, they allow 
the pattern match to occur anywhere in the subject. Therefore, POS(O) or RPOS(O) must be used in 
the pattern structure to force anchoring. For example, the command 

ALTER 1 POS(O) ("THIS" = "THAT") 

will change the word "THIS" to "THAT" in the subject only if it is at the beginning of the subject line. 
On the other hand, the command 

ALTER 1 ("THIS" = "THAT") 

will change the first occurrence of the word "THIS" to "THAT" regardless of where it appears in the line, 
and the command 

ALTEROALL 1 ("THIS" = "THAT") 

will change all occurrences of "THIS" to "THAT" in line 1. 

Other Commands and String Expressions 

When the pattern matching facility is enabled, string expressions (as defined above in "Variables") 
are allowed in an edit command wherever a string is allowed, except for the ALTER, CHANGE, 
MATCH, SCAN, and TRANSLATE commands. 

The ALTER, CHANGE, MATCH, and SCAN commands require patterns (which may contain string 
expressions). The TRANSLATE command syntax becomes 



Pattern Matching 169 



MTS 18: The MTS File Editor 
February 1988 

TRANSLATE lpar string-expl=string-exp2 
An example of the use of string expressions in place of strings is 

INSERT 10 'THE NUMBERS ' ED_09 '.' 

which inserts the string "THE NUMBERS 0123456789." at line 10. 
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EDITOR PATTERN-ELEMENT DEFINITIONS 



The same notation is used for the edit pattern-element definitions as is used for the edit command 
descriptions. 

Summary of Pattern Elements 



* 



* 



* 



string 

ABORT 

ANY(string) 

ANYCASE(string) 

ARB 

ASCII(string) 

BREAK(string) 

BREAKX(string) 

DUPL(string,count) 

EBCDIC(string) 

FAIL 

FENCE 

HEX(string) 

* LC(string) 
LEN(length) 

* LPAD(string,len[,padch]) 
NOTANY(string) 
POS(column) 

REM 

* RPAD(string,len[,padch]) 
RPOS(column) 
RTAB(column) 
SIZE(string) 
SKIP(string) 
SKIPNOT(string) 
SPAN(string) 

* SUBSTR(string,beg[,end]) 

* SUBSTR(string,beg I len) 
TAB(column) 

* UC(string) 

The pattern elements marked with an asterisk are functions which modify a string and return a result. 
Therefore, they may be used in a string expression (strexp) in any edit command that accepts string 
expressions. 
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Purpose: 

Prototype: 

Action: 

Examples: 



string 
Edit Pattern Description 

To match a specified character string. 

string 

The subject is compared with string starting at the current cursor position. If 
the subject contains string, the pattern match is successful; otherwise, the 
pattern match fails. 

The resulting pattern match in the subject line after matching the pattern: 
"versus" 

Comments on the case, Regina versus Christensen, 

I I 



The following ALTER command may be used with the above subject line to 
change "versus" to "vs.": 

ALTER * 'versus' = 'vs.' 

The result is 

Comments on the case, Regina vs. Christensen, 
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Purpose: 

Prototype: 

Action: 

Examples: 



ABORT 

Edit Pattern Description 

To cause a permanent failure of the entire pattern-matching sequence. 

ABORT 

ABORT is a pattern element that will always cause the entire pattern-matching 
sequence to fail. ABORT will prevent the scanner from seeking alternative 
matches. 

The resulting pattern match in the subject line after matching the pattern: 

(POS(O) "*" ABORT) | "BALR" 
STMT1 BALR 14,15 
1 BALR 

The above example tests the subject line for the string "BALR" if and only if the 
first character of the line is not "*". 

The following SCAN command scans the entire file for all BALR assembler 
instructions (while ignoring 370 Assembler "*" comment lines): 

SCAN@ALL /FILE (POS(O) "*" ABORT) | "BALR" 
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Purpose: 
Prototype: 



Action: 



Examples: 



ANY 
Edit Pattern Description 

To match a single character which is selected from a given set of characters. 

ANY( string) 

Parameter: 

string is a string giving the set of characters from which a character is 
to be matched. 

Starting at the current cursor position, ANY will match any single character in 
the subject which is one of those given in string. If the next character in the 
subject does not contain a character given in string, ANY will fail. 

The resulting pattern match in the subject line after matching the pattern: 
ANYC'aeiou") 

Comments on the case, Regina versus Christensen, 
1 — ANYC'aeiou") 

The resulting pattern match in the subject line after matching the pattern: 

BREAK (" ,") ARB ANYC'aeiou") 

Comments on the case, Regina versus Christensen, 



-BREAK ( " , " ) 



-ANYC'aeiou") 



-ARB 



The following SCAN commands will assign the first matched vowel in the above 
subject line to the variable VOWEL: 

SCAN * ANYC'aeiou") $ VOWEL 



SCAN * BREAK (",") ARB ANYC'aeiou") $ VOWEL 

With the first SCAN command, the value of VOWEL is set to "o"; with the second 
SCAN command, the value of VOWEL is set to "e". 
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Purpose: 
Prototype: 



Action: 



Examples: 



ANYCASE 
Edit Pattern Description 

To match a specified character string. 

ANYCASE(string) 

Parameter: 

string is the character string to be matched in the subject. 

The subject is compared with string starting at the current cursor position. If 
the subject contains string, the pattern match is successful; otherwise, the 
pattern match fails. The match is done regardless of the case of the characters 
in the subject and string. For example, ANYCASE("BLERF") matches "bLeRf ', 
"BLErf',and"blerf\ 

For very simple cases, alternation patterns are more efficient than ANYCASE 
patterns. For example, 

SCAN /FILE ("EDITOR" | "Editor" | "editor") 

is more efficient than 

SCAN /FILE ANYCASE ("editor") 

This is because the processing necessary for using ANYCASE involves 
converting each string with the proper first letter ("E" or "e" in the example 
above) to uppercase and then comparing it against the uppercase representation 
stored for ANYCASE. Note, however, for cases involving more than three or 
four alternatives, ANYCASE is more efficient. The alternation given above 
only matches three possibilities out of the sixty-four permutations of the upper 
and lowercase characters in "editor". 

The resulting pattern match in the subject line after matching the pattern: 

ANYCASE ( " regina " ) 

Comments on the case, regina versus Christensen, 

I I 

1 Regina 

The following ALTER command alters all case forms of the word "regina" to 
"Regina" throughout the entire file: 

ALTER@ALL /FILE ANYCASE ("regina") = "Regina" 
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Purpose: 

Prototype: 

Action: 



Examples: 



ARB 
Edit Pattern Description 

To match an arbitrary number of characters. 

ARB 

ARB matches an arbitrary number of characters in the subject starting at the 
current cursor position. This may be zero or more characters and may include 
the remainder of the subject. 

ARB is normally used in conjunction with other pattern elements. ARB 
increases the number of characters matched by moving the cursor one character 
position at a time until the entire pattern succeeds. If the end of the subject is 
reached before the entire pattern succeeds, then ARB will fail. 

In effect, the ARB pattern element moves the cursor from the current cursor 
position across the remainder of the subject until the rest of the pattern 
succeeds (or until the end of the subject is encountered). 

An alternate name for ARB is three dots (...). 

The resulting pattern match in the subject line after matching the pattern: 

"Comments" ARB ", " 

Comments on the case, Regina versus Christensen, 
I I I I I 

'—Comments '—ARB >— , 

The following ALTER command alters the phrase "on the case" to "about the 
case" in the subject line: 

ALTER * "Comments" (ARB = " about the case") "," 

The result is 

Comments about the case, Regina versus Christensen, 
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Purpose: 
Prototype: 



Action: 



ASCII, EBCDIC 
Edit Pattern Description 

To convert an EBCDIC character string into its ASCII equivalent value, or to 
convert an ASCII character string into its EBCDIC equivalent value. 

ASCII(string) 

EBCDIC(string) 

Parameter: 

string is the string to be converted. 

The pattern element ASCII converts the EBCDIC character string in string into 
its ASCII equivalent value. 

The pattern element EBCDIC converts the ASCII character string in string into 
its EBCDIC equivalent value. 

The null string is not allowed as an argument to ASCII or EBCDIC. 
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BREAK 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To match zero or more contiguous characters which are not part of a given set of 
characters. 

BREAK(string) 

Parameter: 

string is a string giving the set of characters to stop matching on. 

Starting at the current cursor position, BREAK will match all the characters in 
the subject up to but not including a character in the subject which is in string. 

BREAK does not match the character it stops on. If the character at the 
current cursor position is a member of string, BREAK will match the null string. 
BREAK will fail if it does not find a character in the subject which is also in 
string. 

The resulting pattern match in the subject line after matching the pattern: 
break ( " " ) 

Comments on the case, Regina versus Christensen, 
I I 

1 BREAK ( " " ) 

The following SCAN command assigns the portion of the subject line matched 
by BREAK to the variable FIRST (in this case the string "Comments"): 

SCAN * BREAK (" ") $ FIRST 

The resulting pattern match in the subject line after matching the pattern: 
break ( ■■ , ■■ ) 

Comments on the case, Regina versus Christensen, 
I I 

1 BREAK ( " , " ) 

The following SCAN command assigns the portion of the subject line matched 
by BREAK to the variable FIRST and the remainder of the string after the 
break character to the variable LAST: 

SCAN * (BREAK (" " ) $ FIRST) " , " (REM $ LAST) 

In this case, FIRST is set to "Comments on the case" and LAST is set to "Regina 
versus Christensen,". 

The resulting pattern match in the subject line after matching the pattern: 
"case" break (",") 
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Comments on the case, Regina versus Christensen, 



In the above example, BREAK matches the null string since the cursor is 
positioned at the break character "," after matching "case" assuming the pattern 
match is performed in unanchored mode. 
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BREAKX 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To match zero or more contiguous characters which are not part of a given set of 
characters. 

BREAKX(string) 

Parameter: 

string is a string giving the set of characters to stop matching on. 

Starting at the current cursor position, BREAKX will match all the characters 
in the subject up to but not including a character in the subject which is in 
string. 

BREAKX does not match the character it stops on. BREAKX will fail if it does 
not find a character in the subject which is also in string. 

BREAKX is the same as BREAK except that BREAKX has implicit alternatives 
which are obtained by scanning past the first break character found and 
scanning to the next break character. In other words, should the pattern fail, 
BREAKX will force scanning past the current break character and match (like 
BREAK) at the next break character. 

Note that BREAKX may be used to replace ARB in many situations where 
BREAK cannot be easily used. For example, the pattern 

"PETS" BREAKX("CD") ( "CATS" | "DOGS") 

may be used to replace 

" PETS " ARB ( " CATS " | " DOGS " ) 

which produces in some circumstances a more efficient pattern when scanning a 
subject line such as 

MY FAVORITE PETS ARE CANARIES, TURTLES, AND DOGS. 

In this case, BREAKX only has to try two alternatives while ARB must try 
several alternatives before "DOGS" is matched. 

Resulting pattern match in the subject line after matching the pattern: 
POS ( ) BREAKX ( " " ) " versus " 

Comments on the case, Regina versus Christensen, 
I I I I 



-BREAKX ( " " ) 



-" versus" 
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If BREAK were used in the above pattern instead of BREAKX, the pattern 
match would fail. 
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Purpose: 
Prototype: 



Action: 



DUPL 
Edit Pattern Description 

To match (or duplicate) a string by a specified number of times. 

DUPL(string,count) 

Parameters: 

string is the string to be matched or duplicated. 

count is the number of times that string is to be duplicated, count 
must be greater than or equal to zero. 

Starting at the current cursor position, DUPL will match the subject string by 
the number of times specified by the count. 

The DUPL pattern may be used in conjunction with the SIZE pattern to replace 
a string with an equivalent number of blanks, e.g., 

ALTER * 'string' $ A = DUPL ( ' ',SIZE(A)) 
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FAIL 
Edit Pattern Description 

Purpose: To cause a local failure in the pattern-matching sequence. 

Prototype: FAIL 

Action: FAIL is a pattern element that will always cause the pattern-matching 

sequence to fail. FAIL is useful for forcing the scanner to seek alternative 
matches. 
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FENCE 
Edit Pattern Description 



Purpose: To prevent an alternative pattern match from backing up past a certain position 

in the subject. 

Prototype: FENCE 

Action: FENCE matches the null string when encountered by the pattern-match 

scanner when moving left to right through a pattern. If a subsequent failure 
causes the scanner to back up to try an alternative pattern, FENCE prevents 
the scanner from trying alternatives prior to its own occurrence in the pattern. 
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Purpose: 
Prototype: 



Action: 



Example: 



HEX 

Edit Pattern Description 

To convert a character representation of a hexadecimal string to its hexadecimal 
value. 

HEX(string) 

Parameter: 

string is the character representation of the hexadecimal string to be 
converted. 

The character representation of the hexadecimal string is converted to its 
hexadecimal value. 

The null string is not allowed as an argument to HEX. 

The following command will scan the file for the character string "ABC" followed 
by the hexadecimal constant "01". 

SCAN /FILE "ABC" HEX ("01") 
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LC,UC 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Example: 



To convert a character string into lowercase, or to convert a character string into 
uppercase. 



LC(string) 
UC(string) 
Parameter: 
string 



is the character string to be converted into lower- or uppercase. 



The pattern element LC converts the character string in string into lowercase 
characters. 

The pattern element UC converts the character string in string into uppercase 
characters. 

The null string is not allowed as an argument to LC or UC. 

The following command will alter all occurrences of the string "fdub", "Fdub", 
"FDub", etc. to the string "FDUB". 

ALTER@ALL /FILE ANYCASE ("f dub") = UCC'fdub") 
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Purpose: 
Prototype: 



Action: 



Examples: 



LEN 
Edit Pattern Description 

To match an arbitrary string of characters of a certain length. 

LEN(length) 

Parameter: 

length is a nonnegative integer value specifying the number of 
characters to match. 

Starting at the current cursor position, LEN will match the next length 
characters in the subject. If there are not length characters remaining in the 
subject, LEN will fail. 

The resulting pattern match in the subject line after matching the pattern: 

LEN (5) 

Comments on the case, Regina versus Christensen, 
I I 

1 LEN ( 5 ) 

The following SCAN command assigns the first five characters of the subject 
line to the variable FIRST: 

SCAN * LEN (5) $ FIRST 

The resulting pattern match in the subject line after matching the pattern: 

LEN (5) RPOS(O) 

Comments on the case, Regina versus Christensen, 

I I 

LEN(5) ! 

The following SCAN command assigns the last five characters of the subject line 
to the variable LAST: 

SCAN * LEN (5) $ LAST RPOS(O) 
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LPAD 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To pad a string to a given length. The padding is done on the left end of the 
string. 

LPAD(string,len[,padch]) 

Parameters: 

string is the string to be padded. 

len is the string length desired. 

padch is the string to be used as the pad character. Only the first 
character will be used. If this parameter is omitted, the 
current editor pad character will be used (defaults to blank). 

The LPAD pattern element pads string on the left with the pad character to 
make it len characters long. If string is already more than len characters in 
length, it is left unchanged; in this case, LPAD still succeeds. 

The LPAD pattern gives the following results: 



LPAD("abc",5) 
LPAD ("abc", 2) 



yields 
yields 



" abc" 
"abc" 
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NOTANY 
Edit Pattern Description 

To match a single character which is not one of a given set of characters. 

NOTANY(string) 

Parameter: 

string is a string giving the set of characters from which a character is 
not to be matched. 

Starting at the current cursor position, NOTANY will match the character in 
that cursor position in the subject which is not one of those given in string. 

The resulting pattern match in the subject line after matching the pattern: 

NOTANY ("aeiou") 

Comments on the case, Regina versus Christensen, 

1 NOTANY ( "aeiou" ) 

The resulting pattern match in subject line after matching the pattern: 

BREAK (",") SPAN(" ,") NOTANY ( "aeiou") 

Comments on the case, Regina versus Christensen, 
I I I I I 



-BREAK ( " , " ) 



1 — NOTANY ( "aeiou" ) 

-SPAN(" ,") 



The following SCAN commands will assign the first matched consonant in the 
above subject line to the variable CONS: 

SCAN * NOTANY ("aeiou") $ CONS 



SCAN * BREAK (",") SPAN(" ,") NOTANY ("aeiou" ) $ CONS 

With the first SCAN command, the value of CONS is set to "C"; with the second 
SCAN command, the value of CONS is set to "R". 
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POS 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To test if the current cursor position in the subject is at a certain column with 
respect to the beginning (left-hand edge) of the subject. 

POS(column) 

Parameter: 

column is a nonnegative integer value specifying the column position to 
be tested. 

The current cursor position relative to the beginning of the subject is compared 
with column. If they are equal, then POS succeeds. If they are not equal, then 
POS fails. POS never moves the current cursor position; when it succeeds it 
matches the null string. 

POS(O) tests for the current cursor position immediately before the first 
character in the string. POS(n) tests for the cursor position immediately after 
the last character in the subject, if the subject is "n" characters long. 

POS is normally used to anchor the pattern match to a certain column position. 
This is useful when the pattern is being used to test for the occurrence of a 
character string starting at a certain column position. 

The resulting pattern match in the subject line after matching the pattern: 
POS (14) "matter" 

The case is a matter of public record; we do not 

I I 

1 matter 

1 POS (14) 

The resulting pattern match in the subject line after matching the pattern: 

SKIPNOT(";") POS (37) 

The case is a matter of public record; we do not 

I I I 



-SKIPNOTf 1 ; ") 



-POS (37) 
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REM 

Edit Pattern Description 

To match the remainder of the subject. 

REM 

Starting at the current cursor position, REM will match all the characters 
remaining in the subject. REM will never fail to match; if the cursor is already 
at the end of the subject, REM will match the null string. 

Note that REM is the equivalent to the pattern element RTAB(O). 

The resulting pattern match in the subject line after matching the pattern: 
"Comments" REM 

Comments on the case, Regina versus Christensen, 
I I I I 



-Comments 



-REM 



The following SCAN command will assign the remainder of the subject line to 
the variable LAST: 

SCAN * "Comments" REM $ LAST 
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RPAD 

Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To pad a string to a given length. The padding is done on the right end of the 
string. 

RPAD(string,len[,padch]) 

Parameters: 

string is the string to be padded. 

len is the string length desired. 

padch is the string to be used as the pad character. Only the first 
character will be used. If this parameter is omitted, the 
current editor pad character will be used (defaults to blank). 

The RPAD pattern element pads string on the right with the pad character to 
make it len characters long. If string is already more than len characters in 
length, it is left unchanged; in this case, RPAD still succeeds. 

The RPAD pattern gives the following results: 



RPAD ("abc", 5) 
RPAD ("abc", 2) 



yields 
yields 



"abc 
"abc" 
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RPOS 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To test if the current cursor position in the subject is at a certain column with 
respect to the end (right-hand edge) of subject. 

RPOS(column) 

Parameter: 

column is a nonnegative integer value specifying the column position to 
be tested. 

The current cursor position relative to the end of the subject is compared with 
column. If they are equal, then RPOS succeeds. If they are not equal, then 
RPOS fails. RPOS never moves the current cursor position; when it succeeds it 
matches the null string. 

RPOS(O) tests for the current cursor position immediately after the last 
character in the string. RPOS(n) tests for the cursor position immediately 
before the first character position in the subject, if the subject is "n" characters 
long. 

RPOS is normally used to anchor the pattern match to a certain column 
position. This is useful when the pattern is being used to test for the 
occurrence of a character string starting at a certain column position. 

The resulting pattern match in the subject line after matching the pattern: 
RPOS (34) "matter" 



The case is 



matter of public record; we do not 

I I 

1 matter 

1 RPOS (34) 



The resulting pattern match in the subject line after matching the pattern: 

SKIPNOTf';") RPOS (11) 

The case is a matter of public record; we do not 
I I I 



-SKIPNOTC';") 



-RPOS (11) 
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RTAB 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To match all characters in the subject string until the current cursor position is 
at a specific column with respect to the end of the string. 

RTAB(column) 

Parameter: 

column is a nonnegative integer value specifying the column position to 
be matched up to. 

The current cursor position with respect to the right-hand end of the subject is 
compared with column. If the current cursor position is less, RTAB fails; 
otherwise, RTAB matches the zero or more characters necessary to move the 
current cursor position to column. 

RTAB(O) moves the current cursor position to immediately after the last 
character in the string. RTAB(n) moves the cursor to the first character 
position in the subject if the subject is "n" characters long. 

Note that RTAB(O) is equivalent to the pattern element REM. 

The resulting pattern match in the subject line after matching the pattern: 

RTAB (2) 

The case is a matter of public record; we do not 



L 



J 



1 RTAB (2) 

The resulting pattern match in the subject line after matching the pattern: 

SKI PNOT ( " ; " ) RTAB ( 2 ) 

The case is a matter of public record; we do not 

I I I I 



-SKIPNOTC; ") 



-RTAB (2) 
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Purpose: 
Prototype: 



Action: 



SIZE 
Edit Pattern Description 

To return the size (the number of characters) of a string. 

SIZE(string) 

Parameter: 

string is the string whose size is to be returned. 

The SIZE pattern returns the number of characters contained in the subject 
string. 

The SIZE pattern may be used in conjunction with the DUPL pattern to replace 
a string with an equivalent number of blanks, e.g., 

ALTER * 'string' $ A = DUPL ( ' ',SIZE(A)) 
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SKIP 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Example: 



To match zero or more contiguous characters which are selected from a given set 
of characters. 

SKIP(string) 

Parameter: 

string is a string giving the set of characters to match (skip over). 

Starting at the current cursor position, SKIP will match all the characters in the 
subject up to a character which is not one of those given in string. 

Note that SKIP will succeed if the character at the current cursor position is not 
one of those of string when it starts matching (i.e., it does not match any 
characters). Thus, SKIP is the same as SPAN except that SPAN must skip at 
least one character and SKIP does not have to. SKIP does not match the 
character it stops on. 

The resulting pattern match in the subject line after matching the pattern: 

BREAK (" ") SKIP(" ") BREAK (" ") 

Comments the case, Regina versus Christensen, 
I I I I I I 



1 BREAK ( ■ ■ ) 

-SKIP(" ") 



1 BREAK ( " " ) 



196 SKIP Edit Pattern 



Purpose: 
Prototype: 



Action: 



Examples: 



MTS 18: The MTS File Editor 
February 1988 

SKIPNOT 
Edit Pattern Description 

To match zero or more contiguous characters which are not part of a given set of 
characters. 

SKIPNOT(string) 

Parameter: 

string is a string giving the set of characters to stop matching on. 

Starting at the current cursor position, SKIPNOT will match all the characters 
in the subject up to a character which is one of those given in string. 

Note that SKIPNOT, unlike BREAK, will succeed if it does not find a character 
in the subject which is also in string (i.e., SKIPNOT will match the entire line). 
SKIPNOT does not match the character it stops on. 

The resulting pattern match in the subject line after matching the pattern: 

SKIPNOT ("/") 

the work was performed under the ID'S belonging, 
I 



1 SKIPNOT("/") 

The resulting pattern match in the subject line after matching the pattern: 

SKIPNOT (" ,") 

the work was performed under the ID'S belonging, 

I I 

1 SKIPNOTt" ,") 

The resulting pattern match in the subject line after matching the pattern: 
"was p" SKIPNOTt" , ") 

the work was performed under the ID'S belonging, 

I I I I 

!— was p !— SKIPNOT (" ,") 
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SPAN 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To match one or more contiguous characters in the subject which are selected 
from a given set of characters. 

SPAN(string) 

Parameter: 

string is a string giving the set of characters to match (skip over). 

Starting at the current cursor position, SPAN will match all the characters in 
the subject up to a character which is not one of those given in string. 

Note that SPAN will fail if the character at the current cursor position is not one 
of those in string when it starts matching (i.e., it does not match any characters). 

The resulting pattern match in the subject line after matching the pattern: 

SPAN ("Com") 

Comments on the case, Regina versus Christensen, 
1 SPAN ("Com") 

The resulting pattern match in the subject line after matching the pattern: 

BREAK (" ") SPAN(" ") BREAK ( " ") 

Comments the case, Regina versus Christensen, 
I I I I I I 

| I BREAK ( " " ) 

1 SPAN(" ") 

BREAK ( " " ) 
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SUBSTR 
Edit Pattern Description 

Purpose: To generate a substring. 

Prototype: SUBSTR(string,beg[,end]) 

SUBSTR(string,beg I len) 

Parameters: 

string is a character string from which a substring is to be generated. 
beg is an integer specifying the character position at which the 

substring is to begin. 1 means the first character position. 
end is an integer specifying the character position at which the 

substring is to end. 
len is an integer specifying the length of the substring from the 

beginning character position. 

If neither end or len is specified, the remainder of string is taken as the 
substring. 

Action: The SUBSTR pattern element generates a substring from the specified 

character string in string. For example, the following substrings are generated 
by the patterns given below: 

SUBSTR ("abcdefghi ",2,4) produces "bed" 
SUBSTR("abcdefghi",3|2) produces "cd" 
SUBSTR("123456789",6) produces "6789" 



Example: Assume a file with the following lines: 



123456789012345 
1234567890 
123456769012 
12345678901234 

The following command will pad each line in the file with sufficient trailing 
blanks so that each line is exactly fifteen characters long. 

ALTER@OPL /FILE COL=ll REM $ A = SUBSTR (A " ",1|5) 

Note: The characters assigned to the variable A by the REM pattern element are 
part of the subject string of the SUBSTR pattern element. Thus, for the third 
line of the file, the subject string to SUBSTR is "12 " and the resulting 

substring is therefore "12 ". 
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TAB 
Edit Pattern Description 



Purpose: 
Prototype: 



Action: 



Examples: 



To match all characters in the subject string until the current cursor position is 
at a specific column with respect to the beginning of the subject. 

TAB(column) 

Parameter: 

column is a nonnegative integer value specifying the column position to 
be matched up to. 

The current cursor position with respect to the left-hand edge of the string is 
compared with column. If the current cursor position is greater, TAB fails; 
otherwise, TAB matches the zero or more characters necessary to move the 
current cursor position to column. 

TAB(O) moves the current cursor position to immediately before the first 
character position in the string. TAB(n) moves the cursor to immediately after 
the last character position in the subject, if the subject is "n" characters long. 

The resulting pattern match in the subject line after matching the pattern: 
tab ( 8 ) 

The case is a matter of public record; we do not 

I I 

1 TAB ( 8 ) 

The resulting pattern match in the subject line after matching the pattern: 

SKIPNOTf" ;") TAB (46) 

The case is a matter of public record; we do not 



L 



-SKIPNOTC; ") 



-TAB (46) 
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INDEX 



Iname, 22 

!name edit command, 93 

$ assignment operator, 167 
$EDIT command, 11 

* (current line), 12 
*F (first line), 12 
*L (last line), 12 
*N (next line), 12 
*P (previous line), 12 
*VB (bottom line), 12 
*VT (top line), 12 

/BACK (/B) region, 20 
/FILE (/F) region, 20 
/HEAD (/H) region, 20 
/MATCH (/M) region, 20 
/name, 19 

/name edit command, 92 
/REVERSE (/R) region, 20 
/SCAN (/S) region, 20 
/TAIL (/T) region, 20 
/VISUAL (/V) region, 20 
/VMARK region, 20 

= replacement operator, 168 

±n edit command, 94 
±n.n edit command, 95 

A (ALL) modifier, 15 
ABORT pattern element, 173 
AC (ANYCASE) modifier, 15 
AC (ANYCASE) option, 75 
ALL option, 75 
ALTER edit command, 30 
ANY pattern element, 163, 174 
ANYCASE pattern element, 175 
APPEND edit command, 31 
Apple Macintosh terminal, 131 
ARB pattern element, 165, 176 
ASCII pattern element, 177 
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assignment operator ($), 167 

BASE option, 75 
BLANK edit command, 32 
BREAK pattern element, 162, 178 
BREAKX pattern element, 180 

CH (CHECKPOINT), edit modifier, 34 
CH (CHECKPOINT) modifier, 15, 22 
CHANGE edit command, 33 
CHECKPOINT edit command, 21, 34 
CHECKPOINT option, 22, 75 
checkpoint/restore, 21 
CLOSE edit command, 35 
COL (COLUMN) modifier, 15 
COLUMN edit command, 19, 36 
COLUMN option, 75 
column range, 18, 36 
COLUMNS keyword, 13, 19 
COMBINE edit command, 38 
COMMENT edit command, 37 
CONCATENATE edit command, 38 
COPY edit command, 39 
CORRECT edit command, 41 
cost field (visual mode), 100 
COUNT edit command, 45 
COUNT keyword, 13 
CSSET subroutine, 27 
current-line pointer, 14, 56, 94, 95 

DEC VT100 terminal, 135 
DELETE edit command, 46 
DUPL pattern element, 182 
DV(DELETEVERIFY) option, 46, 75 

EBCDIC pattern element, 177 
ECHO option, 76 
ED_AZ predefined variable, 166 
ED_COUNT predefined variable, 166 
ED_CURSOR_COL predefined variable, 166 
ED_CURSOR_FIELD predefined variable, 166 
ED_CURSOR_LINE predefined variable, 166 
ED_CURSOR_POS predefined variable, 166 
ED_DATA_COLS predefined variable, 166 
ED_FILENAME predefined variable, 166 
ED_LCAZ predefined variable, 166 
ED_LEFT_COLUMN predefined variable, 166 
ED_LEFT_WINDOW predefined variable, 166 
ED_MSINK predefined variable, 166 
ED_MSOURCE predefined variable, 167 
ED_PF_NAME predefined variable, 167 
ED_RIGHT_COLUMN predefined variable, 167 
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ED_RIGHT_WINDOW predefined variable, 167 
ED_RULER predefined variable, 139 
ED_SAVENAME predefined variable, 167 
ED_SCAN_LINES predefined variable, 167 
ED_SCREEN_LINES predefined variable, 167 
ED_SINK predefined variable, 167 
ED_SOURCE predefined variable, 167 
ED_STATUS predefined variable, 139, 167 
ED_STATUS_DEF predefined variable, 167 
ED_TIME predefined variable, 167 
EDJJCAZ predefined variable, 167 
ED_VMARK_FIRST_COL predefined variable, 167 
ED_VMARK_FIRST_LINE predefined variable, 167 
ED_VMARK_LAST_COL predefined variable, 167 
ED_VMARK_LAST_LINE predefined variable, 167 
ED_VRULER predefined variable, 167 
ED_VRULER_DEF predefined variable, 167 
ED_WORK predefined variable, 167 
ED_09 predefined variable, 167 
edit file, 11 

patterned file, 11 
edit command, !name, 93 

/name, 92 

±n,94 

±n.n, 95 

ALTER, 30 

APPEND, 31 

BLANK, 32 

CHANGE, 33 

CHECKPOINT, 21, 34 

CLOSE, 35 

COLUMN, 19, 36 

COMBINE, 38 

COMMENT, 37 

CONCATENATE, 38 

COPY, 39 

CORRECT, 41 

COUNT, 45 

DELETE, 46 

EDIT, 47 

END, 23 

EXECUTE, 24, 48 

EXPLAIN, 49 

GOTO, 23, 50 

INSERT, 51 

JUSTIFY, 53 

LET, 55, 165 

LINE, 56 

MATCH, 57 

MCMD, 59 

MOVE, 60 

MTS, 61 
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OVERLAY, 62 

PRINT, 63 

PROCEDURE, 22, 65 

REGION, 19, 66 

REMEMBER, 67 

RENUMBER, 68 

REPLACE, 69 

RESTORE, 21, 70 

RETURN, 71 

SAVE, 72 

SCAN, 73 

SET, 75 

SHIFT, 82 

SPREAD, 83 

STOP, 84 

TRANSLATE, 85 

UNDO, 22, 87 

UNLK, 88 

UNLOCK, 88 

VISUAL, 89, 97 

WINDOW, 90 

XEC,65 
EDIT edit command, 11, 47 
edit modifier, A (ALL), 15 

AC (ANYCASE), 15 

CH (CHECKPOINT), 15, 22, 34 

COL (COLUMN), 15 

HEX, 101 

HEX (HEXADECIMAL), 16 

LEN (LENGTH), 16 

LINELENGTH (LENGTH), 16 

LINETEXT (TEXT), 18 

LNR (LINENUMBER), 16 

MACRO, 16 

MCL (MOVECURRENTLINE), 16 

NOT, 16 

OPL (ONCEPERLINE), 17 

PA(PRINTALL), 17 

PC (PRINTCOLUMN), 17 

PLN (PREFIXLINENUMBER), 17 

RS (RESCAN), 17 

RTL (RIGHTTOLEFT), 17 

TR (TRIM), 18 

TX (TEXT), 18 

V (VERIFY), 18 

VMV(VISUALMODEVERIFY), 18, 101 

W (WINDOW), 18 

X (HEXADECIMAL), 16 
edit modifiers, 15 
edit procedure, 22, 47, 48, 65, 93 
editor initialization file, 20 
editor options, 75 
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editor status, 27 
editor variable, 55, 165 
END edit command, 23 
ENDOFFILE switch, 23, 50 
ERROREXIT option, 76 
EXECUTE edit command, 24, 48 
EXPLAIN edit command, 49 

FAIL pattern element, 183 
FAILURE switch, 23, 50 
FENCE pattern element, 184 
FILLCHAR option, 57, 62, 76 
FUNCTION device command (Amigo), 118 
FUNCTION device command (Ontel), 112 

GOTO edit command, 23, 50 

HEX (HEXADECIMAL) modifier, 16, 101 
HEX pattern element, 185 
HEXADECIMAL option, 76 

IBM PC terminal, 120 
IBM 3278 terminal, 137 
INITFILE option, 20 
initialization file, 20 
INSERT edit command, 51 

JUSTIFY edit command, 53 

LC option, 76, 101 

LC pattern element, 186 

LEN (LENGTH) modifier, 16 

LEN pattern element, 162, 187 

LENGTH option, 76 

LET edit command, 55, 165 

LINE edit command, 56 

line number, 12 

line-number parameter, 12 

LINELENGTH (LENGTH) modifier, 16 

LINETEXT (TEXT) modifier, 18 

LINETEXT option, 80 

LNR (LINENUMBER) modifier, 16 

LNR (LINENUMBER) option, 76 

LP AD pattern element, 188 

Macintosh terminal, 131 

macro editing, 47 

MACRO modifier, 16 

MATCH edit command, 57 

MAXLINE option, 76 

MCL (MOVECURRENTLINE) modifier, 14, 16 

MCL (MOVECURRENTLINE) option, 14, 77 
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MCMD edit command, 59 
MINLINE option, 77 
modifiers, 15 
MOVE edit command, 60 
MTS edit command, 61 

NOT modifier, 16 

NOT option, 77 

NOTANY pattern element, 163, 189 

NPP (NONPRINTPROTECT) option, 77, 101 

Ontel Amigo terminal, 115 
Ontel terminal, 98, 108 
OPL (ONCEPERLINE) modifier, 17 
OPL (ONCEPERLINE) option, 77 
OVERLAY edit command, 62 

PA (PRINTALL) modifier, 17 

PA (PRINTALL) option, 77 

PAD device command (Ontel), 110 

PADCHAR option, 77 

Pattern matching, 159 

PATTERNS option, 78, 159 

PC (PRINTCOLUMN) modifier, 17 

PC (PRINTCOLUMN) option, 78 

PLN (PREFIXLINENUMBER) modifier, 17 

PLN (PREFIXLINENUMBER) option, 78 

PMAR (PRINTMARGIN) option, 78 

POS pattern element, 164, 190 

predefined regions, 20 

predefined variable, 166 

PRINT edit command, 63 

procedure, 22 

PROCEDURE edit command, 22, 65 

region, 19, 66, 92 
REGION edit command, 19, 66 
REM pattern element, 164, 191 
REMEMBER edit command, 67 
REMEMBER option, 78 
RENUMBER edit command, 68 
REPLACE edit command, 69 
replacement operator (=), 168 
REPSCAN option, 78 
RESTORE edit command, 21, 70 
RETURN edit command, 71 
RIGHTTOLEFT (RTL) option, 79 
RPAD pattern element, 192 
RPOS pattern element, 164, 193 
RPSCDELIM option, 78 
RPSECHO option, 78 
RS (RESCAN) modifier, 17 
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RS (RESCAN) option, 79 
RTAB pattern element, 164, 194 
RTL (RIGHTTOLEFT) modifier, 17 
ruler area (visual mode), 97 

SAVE edit command, 72 
SAVE option, 79 
save/remember facility, 67, 72 
SAVEREMEMBER option, 79 
SCAN edit command, 73 
SET edit command, 75 
SHIFT edit command, 82 
SIZE pattern element, 195 
SKIP pattern element, 163, 196 
SKIPNOT pattern element, 197 
SPAN pattern element, 162, 198 
SPELLCOR option, 79 
SPREAD edit command, 83 
STOP edit command, 84 
STOP option, 80 
string, 14 

string pattern element, 172 
SUBSTR pattern element, 199 
SUCCESS switch, 23, 50 

TAB pattern element, 164, 200 

TIMEINTERVAL option, 80 

TR (TRIM) modifier, 18 

TRANSLATE edit command, 85 

TRIM option, 80 

TX (TEXT) modifier, 18 

TX (TEXT) option, 80 

UC pattern element, 186 
UNDO edit command, 22, 87 
UNLK edit command, 88 
UNLOCK edit command, 88 

V (VERIFY) modifier, 18 
VCURSOR visual-mode command, 142 
VERIFY option, 46, 80 
VEXECUTE visual-mode command, 143 
VEXIT visual-mode command, 144 
VEXTEND visual-mode command, 145 
VINSERT visual-mode command, 146 
VISUAL edit command, 89, 97 
visual mode, 97 
VISUAL option, 80 

visual program function (VPF), 99, 109, 115, 121, 127, 132 
visual ruler area, 139 
visual-mode command, VCURSOR, 142 
VEXECUTE, 143 
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VEXIT, 144 

VEXTEND, 145 

VINSERT, 146 

VMARK, 148 

VMEMORY, 149 

VPF, 151 

VPFB, 153 

VPFE, 154 

VPREVIOUS, 155 

VSPLIT, 156 

VTEST, 157 

VUPDATE, 158 
VMARK visual-mode command, 148 
VMARKER option, 14, 80 
VMCOST option, 80, 100 
VMEMORY visual-mode command, 149 
VML option, 81 

VMV(VISUALMODEVERIFY) modifier, 18, 101 
VMV (VISUALMODEVERIFY) option, 81, 101 
VPF visual-mode command, 151 
VPFB visual-mode command, 153 
VPFE visual-mode command, 154 
VPREVIOUS visual-mode command, 155 
VSPLIT visual-mode command, 156 
VTEST visual-mode command, 157 
VUPDATE visual-mode command, 158 

W (WINDOW) modifier, 18 
WINDOW edit command, 90 
WINDOW option, 81 
work area (visual mode), 97 

X (HEXADECIMAL) modifier, 16 

X option, 76 

XEC edit command, 65 

Zenith 100 terminal, 126 
Zenith 150 terminal, 120 
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